Gitee MCP Server

Gitee MCP Sunucusu

Gitee MCP Sunucusu, Gitee için bir Model Bağlam Protokolü (MCP) sunucu uygulamasıdır. Gitee'nin API'si ile etkileşim kurmak için bir dizi araç sunarak yapay zeka asistanlarının depoları, konuları, çekme isteklerini ve daha fazlasını yönetmesine olanak tanır.

Özellikler

• Gitee depoları, konuları, çekme istekleri ve bildirimleriyle etkileşim
• Farklı Gitee örneklerini desteklemek için yapılandırılabilir API temel URL'si
• Kolay yapılandırma için komut satırı bayrakları
• Kişisel, organizasyon ve kurumsal işlemleri destekler
• Dinamik araç seti etkinleştirme/devre dışı bırakma

Pratik senaryo: Depodan Konu alın, uygulayın ve bir Çekme İsteği oluşturun

1. Depo Konularını alın
2. Kodlamayı uygulayın ve Konu ayrıntılarına dayalı Çekme İsteği oluşturun
3. Yorum yapın ve Konuyu kapatın

Kurulum (npx ile başlatırken bu adım doğrudan atlanabilir)

Ön Koşullar

• Go 1.23.0 veya üstü
• Erişim belirteci olan Gitee hesabı, Almak için gidin

Kaynaktan Derleme

1. Depoyu klonlayın:

   git clone https://gitee.com/oschina/mcp-gitee.git
   cd mcp-gitee
   

2. Projeyi derleyin:

   make build
   

   ./bin/mcp-gitee PATH ortamına taşıyın

go install kullanın

go install gitee.com/oschina/mcp-gitee@latest

Kullanım

mcp-gitee sürümünü kontrol edin:

mcp-gitee --version

MCP Ana Bilgisayar Yapılandırması

Yapılandırma örnekleri: Daha fazla uygulama yapılandırması görüntülemek için tıklayın

• Claude Code
• Codex
• Cursor
• Trae
• Cline
• Continue
• opencode

Uzak MCP Sunucusu

Resmi uzak mcp-gitee sunucusuna bağlanın (kurulum gerekmez):

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      }
    }
  }
}

Codex ~/.codex/config.toml kullanır:

[mcp_servers.gitee]
url = "https://api.gitee.com/mcp"
bearer_token_env_var = "GITEE_ACCESS_TOKEN"

opencode ~/.config/opencode/opencode.json kullanır:

{
  "mcp": {
    "gitee": {
      "type": "remote",
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>"
      },
      "enabled": true
    }
  }
}

Komut Satırı Seçenekleri

• --token: Gitee erişim belirteci
• --api-base: Gitee API temel URL'si (varsayılan: https://gitee.com/api/v5)
• --version: Sürüm bilgisini göster
• --transport: Taşıma türü (stdio, sse veya http, varsayılan: stdio)
• --address: Sunucunun başlatılacağı ana bilgisayar ve bağlantı noktası (varsayılan: localhost:8000)
• --enabled-toolsets: Etkinleştirilecek araçların virgülle ayrılmış listesi (belirtilirse, yalnızca bu araçlar etkinleştirilir)
• --disabled-toolsets: Devre dışı bırakılacak araçların virgülle ayrılmış listesi

Ortam Değişkenleri

Sunucuyu ortam değişkenlerini kullanarak da yapılandırabilirsiniz:

• GITEE_ACCESS_TOKEN: Gitee erişim belirteci
• GITEE_API_BASE: Gitee API temel URL'si
• ENABLED_TOOLSETS: Etkinleştirilecek araçların virgülle ayrılmış listesi
• DISABLED_TOOLSETS: Devre dışı bırakılacak araçların virgülle ayrılmış listesi

Araç Seti Yönetimi

Araç seti yönetimi iki modu destekler:

1. Belirtilen araçları etkinleştir (beyaz liste modu):

   • --enabled-toolsets parametresini veya ENABLED_TOOLSETS ortam değişkenini kullanın
   • Belirtildikten sonra, yalnızca listelenen araçlar etkinleştirilir, diğerleri devre dışı bırakılır
   • Örnek: --enabled-toolsets="list_user_repos,get_file_content"

2. Belirtilen araçları devre dışı bırak (kara liste modu):

   • --disabled-toolsets parametresini veya DISABLED_TOOLSETS ortam değişkenini kullanın
   • Belirtildikten sonra, listelenen araçlar devre dışı bırakılır, diğerleri etkinleştirilir
   • Örnek: --disabled-toolsets="list_user_repos,get_file_content"

Not:

• Hem enabled-toolsets hem de disabled-toolsets belirtilirse, enabled-toolsets önceliklidir
• Araç adları büyük/küçük harfe duyarlıdır

İstek Başına Araç Filtreleme (HTTP Başlıkları)

Uzak MCP sunucusunu (HTTP/SSE taşıması) kullanırken, HTTP başlıkları aracılığıyla istek başına kullanılabilir araçları dinamik olarak filtreleyebilirsiniz. Bu, sunucuyu yeniden başlatmadan araç maruziyeti üzerinde ince taneli kontrole ihtiyaç duyan istemciler için kullanışlıdır.

1. Başlık aracılığıyla belirtilen araçları etkinleştir (beyaz liste):

   • X-MCP-Enabled-Tools başlığını kullanın
   • Bu istek için yalnızca listelenen araçlar etkinleştirilir
   • Örnek: X-MCP-Enabled-Tools: list_user_repos,get_file_content

2. Başlık aracılığıyla belirtilen araçları devre dışı bırak (kara liste):

   • X-MCP-Disabled-Tools başlığını kullanın
   • Bu istek için listelenen araçlar devre dışı bırakılır
   • Örnek: X-MCP-Disabled-Tools: create_repo,delete_repo

Öncelik kuralları:

• Aynı istekte hem X-MCP-Enabled-Tools hem de X-MCP-Disabled-Tools varsa, beyaz liste (X-MCP-Enabled-Tools) önceliklidir
• Araç adları büyük/küçük harfe duyarlıdır

Cursor/Claude için örnek yapılandırma:

{
  "mcpServers": {
    "gitee": {
      "url": "https://api.gitee.com/mcp",
      "headers": {
        "Authorization": "Bearer <your personal access token>",
        "X-MCP-Enabled-Tools": "list_user_repos,get_file_content,list_repo_issues"
      }
    }
  }
}

Lisans

Bu proje MIT Lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE dosyasına bakın.

Kullanılabilir Araçlar

Sunucu, Gitee ile etkileşim kurmak için çeşitli araçlar sağlar:

Araç	Kategori	Açıklama
list_user_repos	Depo	Kullanıcı yetkili depolarını listele
get_file_content	Depo	Bir depodaki dosyanın içeriğini al
create_repo	Depo	Bir depo oluştur (kullanıcı, organizasyon veya kurumsal)
fork_repository	Depo	Bir depoyu çatalla
create_release	Depo	Bir depo için sürüm oluştur
list_releases	Depo	Depo sürümlerini listele
search_open_source_repositories	Depo	Gitee'de açık kaynak depoları ara
search_files_by_content	Depo	Bir depoda içeriğe göre dosya ara
compare_branches_tags	Depo	Bir depoda iki dalı, etiketi veya commit'i karşılaştır
list_repo_pulls	Çekme İsteği	Bir depodaki çekme isteklerini listele
merge_pull	Çekme İsteği	Bir çekme isteğini birleştir
create_pull	Çekme İsteği	Bir çekme isteği oluştur
update_pull	Çekme İsteği	Bir çekme isteğini güncelle
get_pull_detail	Çekme İsteği	Bir çekme isteğinin ayrıntılarını al
get_diff_files	Çekme İsteği	Bir çekme isteği fark dosyalarını al
manage_pull_review	Çekme İsteği	Bir çekme isteği incelemesini yönet (onayla veya iptal et)
create_comment	Yorum	Bir konu veya çekme isteğine yorum oluştur
list_comments	Yorum	Bir konu veya çekme isteği için tüm yorumları listele
create_issue	Konu	Bir konu oluştur
update_issue	Konu	Bir konuyu güncelle
get_repo_issue_detail	Konu	Bir depo konusunun ayrıntılarını al
list_repo_issues	Konu	Depo konularını listele
get_user_info	Kullanıcı	Mevcut kimliği doğrulanmış kullanıcı bilgilerini al
search_users	Kullanıcı	Kullanıcıları ara
list_user_notifications	Bildirim	Kullanıcı bildirimlerini listele

Katkı

Açık kaynak topluluğundan katkıları memnuniyetle karşılıyoruz! Bu projeye katkıda bulunmak isterseniz, lütfen şu yönergeleri izleyin:

1. Depoyu çatallayın.
2. Özelliğiniz veya hata düzeltmeniz için yeni bir dal oluşturun.
3. Değişikliklerinizi yapın ve kodun iyi belgelendiğinden emin olun.
4. Değişikliklerinizin net bir açıklamasıyla bir çekme isteği gönderin.

Daha fazla bilgi için lütfen CONTRIBUTING dosyasına bakın.