GitHub PR Reviewer MCP

GitHub Pull Request'lerini analiz eden Model Context Protocol (MCP) sunucusu. Bu araç, Claude Desktop ile entegre çalışarak GitHub PR'larını detaylı şekilde incelemenizi sağlar.

🚀 Özellikler

• ✅ PR Detayları: Pull Request'in genel bilgilerini, istatistiklerini ve meta verilerini görüntüleme
• ✅ Diff İnceleme: PR'daki kod değişikliklerini detaylı şekilde inceleme
• ✅ Dosya Listesi: Değiştirilen dosyaların listesini ve istatistiklerini görme
• ✅ Review Takibi: Mevcut code review'ları ve yorumları okuma
• ✅ GitHub Token Desteği: İsteğe bağlı token ile rate limit artırma
• ✅ Türkçe Arayüz: Tamamen Türkçe raporlama

📋 Gereksinimler

• Node.js 18+
• npm veya yarn
• Claude Desktop
• GitHub hesabı (token için)

🔧 Kurulum

1. Projeyi Klonlayın veya İndirin

git clone <repo-url>
cd github-pr-reviewer-mcp

2. Bağımlılıkları Yükleyin

npm install

3. Projeyi Derleyin

npm run build

4. GitHub Token Oluşturun (Önerilen)

GitHub token olmadan da çalışır, ancak rate limit düşük olur.

1. GitHub Settings > Developer settings > Personal access tokens sayfasına gidin
2. "Generate new token (classic)" seçin
3. Aşağıdaki izinleri verin:
   • repo (repository erişimi)
   • read:org (organizasyon bilgileri)
4. Token'ı kopyalayın ve güvenli bir yerde saklayın

5. Claude Desktop Konfigürasyonu

Claude Desktop'ın MCP konfigürasyon dosyasını düzenleyin:

Windows:

%APPDATA%\Claude\claude_desktop_config.json

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Linux:

~/.config/Claude/claude_desktop_config.json

Dosya içeriği:

{
  "mcpServers": {
    "github-pr-reviewer": {
      "command": "node",
      "args": [
        "C:\\tam\\yol\\projenize\\build\\index.js"
      ],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Not:

• C:\\tam\\yol\\projenize\\build\\index.js kısmını kendi proje yolunuzla değiştirin
• ghp_your_token_here kısmına GitHub token'ınızı yazın
• Token opsiyoneldir, "env" kısmını tamamen çıkarabilirsiniz

6. Claude Desktop'ı Yeniden Başlatın

Konfigürasyon değişikliklerinin etkili olması için Claude Desktop'ı tamamen kapatıp açın.

📖 Kullanım

Claude Desktop'ta MCP sunucusu aktif olduktan sonra, aşağıdaki komutları kullanabilirsiniz:

1. Pull Request İnceleme

Bu PR'ı incele: https://github.com/microsoft/vscode/pull/12345

Çıktı örneği:

📋 Pull Request Review Raporu

## Genel Bilgiler
- Başlık: Fix memory leak in extension host
- Durum: 🟢 Açık
- Yazar: @john-doe
- Oluşturulma: 15.10.2025
- Branch: fix/memory-leak → main

## İstatistikler
- ➕ Eklenen satır: 45
- ➖ Silinen satır: 12
- 📁 Değiştirilen dosya: 3
- 💬 Yorum sayısı: 8
- 📝 Review sayısı: 2
- ✅ Commit sayısı: 4

2. Diff İçeriğini Görme

Şu PR'ın diff'ini getir: https://github.com/microsoft/vscode/pull/12345

Çıktı: PR'daki tüm kod değişikliklerini diff formatında gösterir.

3. Değiştirilen Dosyaları Listeleme

Bu PR'da hangi dosyalar değişmiş: https://github.com/microsoft/vscode/pull/12345

Çıktı örneği:

📁 Pull Request Dosyaları

Toplam 3 dosya değişti:

- src/extension.ts (modified)
  - ➕ 25 / ➖ 8 satır
  - Değişiklik: 33 satır

- package.json (modified)  
  - ➕ 2 / ➖ 1 satır
  - Değişiklik: 3 satır

🛠️ Geliştirme

Watch Modu

Geliştirme sırasında otomatik derleme için:

npm run watch

Test Etme

Sunucuyu manuel olarak test etmek için:

npm start

Bu komut sunucuyu stdin/stdout modunda başlatır.

⚙️ Konfigürasyon

Çevre Değişkenleri

• GITHUB_TOKEN: GitHub API token'ı (opsiyonel)
  • Token olmadan saatte 60 istek limiti
  • Token ile saatte 5000 istek limiti

Desteklenen GitHub URL Formatları

• https://github.com/owner/repo/pull/123
• http://github.com/owner/repo/pull/456

🐛 Sorun Giderme

"MCP sunucusu bulunamadı" hatası

1. Claude Desktop konfigürasyon dosyasının doğru yolda olduğunu kontrol edin
2. JSON formatının geçerli olduğunu kontrol edin
3. Dosya yollarının doğru olduğunu ve build/index.js dosyasının var olduğunu kontrol edin
4. Claude Desktop'ı yeniden başlatın

"GitHub API hatası" mesajı

1. GitHub token'ınızın geçerli olduğunu kontrol edin
2. Token'ın gerekli izinlere sahip olduğunu kontrol edin
3. Rate limit'e takılmış olabilirsiniz, biraz bekleyin
4. Repository'nin public olduğunu veya token'ın erişim hakkına sahip olduğunu kontrol edin

"Build bulunamadı" hatası

npm run build

komutu ile projeyi yeniden derleyin.

📝 Lisans

MIT License - Detaylar için LICENSE dosyasına bakın.

🤝 Katkıda Bulunma

1. Fork edin
2. Feature branch oluşturun (git checkout -b feature/amazing-feature)
3. Commit edin (git commit -m 'Add amazing feature')
4. Push edin (git push origin feature/amazing-feature)
5. Pull Request açın

📞 Destek

Sorunlarınız için GitHub Issues kullanın veya doğrudan iletişime geçin.

---

Not: Bu araç GitHub API'sını kullanır ve GitHub'ın hizmet koşullarına tabidir.