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) ```json { "mcpServers": { "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "<PAT_TOKEN>" } } } } ``` ### 3. Alternatif: Docker ile ```json { "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