vibeeval/github-mcp

GitHub MCP Server

GitHub MCP vs gh CLI

| Ozellik | GitHub MCP | gh CLI | |---------|-----------|--------| | Kurulum | MCP server config | brew install gh | | Auth | PAT token (MCP env) | gh auth login (interactive) | | Kullanim | Tool call (agent icinden) | Bash komutu | | Rate limit | REST API limit (5000/h) | Ayni | | Avantaj | Agent workflow icinde seamless | Terminal scripting | | Dezavantaj | MCP server calisir olmali | Agent context'ten cikmak lazim |

Ne Zaman Hangisi

GitHub MCP kullan:
  - Agent workflow icinde GitHub islemleri gerektiginde
  - Birden fazla API call zincirlenecekse
  - Structured data response lazimsa

gh CLI kullan:
  - Tek seferlik terminal islemleri
  - PR olusturma/merge (interaktif)
  - Git hook'lari icinde
  - Script/otomasyon icinde

MCP Server Kurulumu

1. GitHub PAT Token Olustur

GitHub Settings > Developer Settings > Personal Access Tokens > Fine-grained
Gerekli permission'lar:
  - Repository: Read/Write
  - Issues: Read/Write
  - Pull Requests: Read/Write
  - Actions: Read/Write (workflow tetikleme)
  - Webhooks: Read/Write (webhook yonetimi)
  - Organization: Read (org API)

2. MCP Config (~/.mcp.json)

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<PAT_TOKEN>"
      }
    }
  }
}

3. Alternatif: Docker ile

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<PAT_TOKEN>"
      }
    }
  }
}

Repository Yonetimi

Repo Olusturma

mcp_github.create_repository({
  name: "my-project",
  description: "Proje aciklamasi",
  private: true,
  auto_init: true  // README ile baslat
})

Repo Bilgisi

mcp_github.get_repository({
  owner: "username",
  repo: "repo-name"
})
// Response: stars, forks, open_issues, default_branch, language

Fork

mcp_github.fork_repository({
  owner: "original-owner",
  repo: "original-repo"
})

Branch Yonetimi

// Branch olustur
mcp_github.create_branch({
  owner: "username",
  repo: "repo-name",
  branch: "feature/new-feature",
  from_branch: "main"
})

// Branch listele
mcp_github.list_branches({
  owner: "username",
  repo: "repo-name"
})

Issue Yonetimi

Issue Olusturma

mcp_github.create_issue({
  owner: "username",
  repo: "repo-name",
  title: "Bug: Login form broken",
  body: "## Steps to reproduce\n1. Go to /login\n2. Enter credentials\n3. Click submit\n\n## Expected\nRedirect to dashboard\n\n## Actual\n500 error",
  labels: ["bug", "P1"],
  assignees: ["developer-username"]
})

Issue Listeleme / Filtreleme

mcp_github.list_issues({
  owner: "username",
  repo: "repo-name",
  state: "open",
  labels: "bug",
  sort: "created",
  direction: "desc"
})

Issue Guncelleme

mcp_github.update_issue({
  owner: "username",
  repo: "repo-name",
  issue_number: 42,
  state: "closed",
  labels: ["bug", "resolved"]
})

Issue Yorum

mcp_github.add_issue_comment({
  owner: "username",
  repo: "repo-name",
  issue_number: 42,
  body: "Fixed in PR #45"
})

Pull Request Yonetimi

PR Olusturma

mcp_github.create_pull_request({
  owner: "username",
  repo: "repo-name",
  title: "feat: Add user authentication",
  body: "## Summary\n- JWT auth implementation\n- Login/register endpoints\n\n## Test plan\n- [ ] Unit tests pass\n- [ ] Integration tests pass",
  head: "feature/auth",
  base: "main",
  draft: false
})

PR Review

// Review olustur
mcp_github.create_review({
  owner: "username",
  repo: "repo-name",
  pull_number: 45,
  event: "APPROVE",  // APPROVE | REQUEST_CHANGES | COMMENT
  body: "LGTM! Clean implementation."
})

PR Merge

mcp_github.merge_pull_request({
  owner: "username",
  repo: "repo-name",
  pull_number: 45,
  merge_method: "squash"  // merge | squash | rebase
})

PR Dosya Degisiklikleri

mcp_github.get_pull_request_files({
  owner: "username",
  repo: "repo-name",
  pull_number: 45
})
// Response: filename, status (added/modified/removed), additions, deletions

Code Search

Repository Icinde Arama

mcp_github.search_code({
  query: "useEffect cleanup repo:username/repo-name",
  per_page: 10
})

Global Arama

// Dil filtreyle
mcp_github.search_code({
  query: "rate limiter language:typescript stars:>100"
})

// Organizasyon icinde
mcp_github.search_code({
  query: "database migration org:my-org"
})

Arama Operatorleri

repo:owner/name       # Spesifik repo
org:organization      # Organizasyon icinde
path:src/utils        # Path filtresi
filename:config.ts    # Dosya adi
extension:py          # Uzanti
language:typescript   # Dil
stars:>100            # Minimum star
size:>1000            # Minimum byte

Actions Workflow

Workflow Tetikleme

mcp_github.create_workflow_dispatch({
  owner: "username",
  repo: "repo-name",
  workflow_id: "deploy.yml",
  ref: "main",
  inputs: {
    environment: "production",
    version: "v1.2.3"
  }
})

Workflow Runs Listeleme

mcp_github.list_workflow_runs({
  owner: "username",
  repo: "repo-name",
  workflow_id: "ci.yml",
  status: "completed",
  per_page: 5
})

Workflow Run Loglari

mcp_github.get_workflow_run_logs({
  owner: "username",
  repo: "repo-name",
  run_id: 12345
})

Release Management

Release Olusturma

mcp_github.create_release({
  owner: "username",
  repo: "repo-name",
  tag_name: "v1.2.3",
  name: "Release v1.2.3",
  body: "## What's Changed\n- feat: User auth (#42)\n- fix: Login redirect (#45)\n\n## Breaking Changes\nNone",
  draft: false,
  prerelease: false
})

Release Listeleme

mcp_github.list_releases({
  owner: "username",
  repo: "repo-name",
  per_page: 10
})

Latest Release

mcp_github.get_latest_release({
  owner: "username",
  repo: "repo-name"
})

Webhook Yonetimi

Webhook Olusturma

mcp_github.create_webhook({
  owner: "username",
  repo: "repo-name",
  config: {
    url: "https://my-server.com/webhook",
    content_type: "json",
    secret: "webhook-secret-123"
  },
  events: ["push", "pull_request", "issues"],
  active: true
})

Webhook Events

| Event | Ne Zaman | Kullanim | |-------|----------|----------| | push | Commit push | CI/CD tetikle | | pull_request | PR acildi/kapandi | Review notify | | issues | Issue degisti | Triage bot | | release | Release yayinlandi | Deploy tetikle | | workflow_run | Action tamamlandi | Status notify | | star | Repo star'landi | Analytics |

Organization & Team API

Org Bilgisi

mcp_github.get_organization({
  org: "my-organization"
})

Team Listeleme

mcp_github.list_teams({
  org: "my-organization"
})

Team Members

mcp_github.list_team_members({
  org: "my-organization",
  team_slug: "backend-team"
})

Org Repo'lari

mcp_github.list_org_repos({
  org: "my-organization",
  type: "all",
  sort: "updated"
})

Rate Limiting

Limitler

| Auth Tipi | Limit | Reset | |-----------|-------|-------| | PAT (authenticated) | 5000 req/h | 1 saat | | Unauthenticated | 60 req/h | 1 saat | | Search API | 30 req/min | 1 dakika | | GraphQL | 5000 points/h | 1 saat |

Rate Limit Kontrol

mcp_github.get_rate_limit()
// Response: { limit, remaining, reset_at }

Best Practices

1. Conditional requests (If-None-Match header) kullan
2. Pagination ile kucuk sayfalarda cek (per_page: 30)
3. Search API'yi 30 req/min altinda tut
4. 403 + "rate limit exceeded" alirsan reset_at kadar bekle
5. Webhook kullan (polling yerine event-driven)
6. GraphQL kullan (birden fazla REST call yerine tek query)

Workflow Ornekleri

Yeni Feature Workflow

1. Issue olustur (task tanimla)
2. Branch olustur (feature/X)
3. Kod yaz, commit et
4. PR olustur (issue'ya referans ver)
5. Review iste
6. Merge et (squash)
7. Release olustur (tag ile)

Bug Fix Workflow

1. Issue olustur (bug raporu)
2. Branch olustur (fix/X)
3. Fix yaz, test ekle
4. PR olustur (Fixes #issue-number)
5. CI gectigini dogrula
6. Merge et
7. Issue otomatik kapanir

CI/CD Tetikleme

1. Push event -> CI workflow calisir
2. PR event -> Test + lint + security scan
3. Release event -> Deploy workflow calisir
4. Workflow dispatch -> Manuel deploy

Anti-Patterns

| Anti-Pattern | Dogru Yol | |-------------|-----------| | PAT'i koda gomme | .env veya MCP config env | | Tum permission'lari ver | Minimum gerekli scope | | Polling ile status kontrol | Webhook kullan | | Buyuk sayfa boyutu (100+) | per_page: 30, pagination | | Rate limit'i yoksay | get_rate_limit ile kontrol | | Force push main'e | Branch protection + PR |