GitMCP

GitMCP Nedir • Özellikler • Başlangıç • Nasıl Çalışır • Badge • Örnekler • SSS • Gizlilik • Katkıda Bulunma • Lisans

🤔 GitMCP Nedir?

Varsayımsal kodlamayı bırakın, gerçek kodlamaya başlayın!

GitMCP, herhangi bir GitHub projesini (repositories veya GitHub pages) bir dokümantasyon merkezine dönüştüren ücretsiz, açık kaynaklı, uzak bir Model Context Protocol (MCP) sunucusudur. Cursor gibi AI araçlarının güncel dokümantasyona ve koda erişmesini sağlar; LLM bunlarla daha önce karşılaşmış olsa da olmasa da. Bu sayede kod hallüsinasyonlarını sorunsuzca ortadan kaldırır.

GitMCP iki çeşit destekler -

• Belirli Repository (gitmcp.io/{owner}/{repo} veya {owner}.gitmcp.io/{repo}): Birkaç kütüphaneyle çalıştığınızda bunları kullanın. Bu, AI asistanınızın her zaman doğru projeyi hedef almasını sağlar, güvenliği ve ilgiliği artırır ve istenmeyen repositorylere erişimi önler.
• Genel Sunucu (gitmcp.io/docs): Farklı repositoryler arasında sık sık geçiş yapmanız gerektiğinde maksimum esneklik için bunu kullanın. AI asistanı, her istek için erişilecek repository'yi sizden sorabilir (veya bağlama göre karar verebilir). Bunun her seferinde hedef repository'yi doğru bir şekilde tanımlamaya dayandığını unutmayın.

GitMCP ile:

• AI asistanları en son dokümantasyona ve koda doğrudan kaynaktan erişir.
• Doğru API kullanımı ve güvenilir kod örnekleri alırsınız.
• Niş, yeni veya hızla değişen kütüphanelerle etkili bir şekilde çalışırsınız.
• Hallüsinasyonlar önemli ölçüde azalır ve kod doğruluğu iyileşir.

Örneğin, bu yan yana karşılaştırma, Cursor'da three.js sahnesi oluştururken aynı tek yönerge için sonucu gösterir -

https://github.com/user-attachments/assets/fbf1b4a7-f9f0-4c0e-831c-4d64faae2c45

✨ Özellikler

• 😎 HERHANGİ GitHub Projesi için Son Dokümantasyon: AI asistanınıza GitHub projesinin dokümantasyonuna ve koduna sorunsuz erişim izni verin. Yerleşik akıllı arama özellikleri, çok sayıda token kullanmadan AI'nin ihtiyaç duyduğu tam şeyi bulmanıza yardımcı olur!
• 🧠 Artık Hallüsinasyon Yok: GitMCP ile AI asistanınız sorularınıza doğru ve ilgili cevaplar verebilir.
• ☁️ Sıfır Kurulum: GitMCP bulutta çalışır. Seçilen GitMCP URL'sini IDE'nizdeki bir MCP sunucusu olarak ekleyin — indirme, kurulum, kayıt veya değişiklik gerekmez.
• 💬 Gömülü Sohbet: Repository'nin dokümantasyonuyla doğrudan tarayıcıdaki sohbetimiz aracılığıyla hızlıca başlayın!
• ✅ Açık, Ücretsiz ve Özel: GitMCP açık kaynaklıdır ve tamamen ücretsiz kullanılabilir. Kişisel bilgileri toplamaz veya sorguları saklamaz. Kendi başınıza barındırabilirsiniz!

🚀 Başlangıç

GitMCP'yi kullanmak kolaydır! Sadece şu adımları izleyin:

Adım 1: İstediğiniz sunucu türünü seçin

Neye bağlanmak istediğinize bağlı olarak bu URL formatlarından birini seçin:

• GitHub repositories için: gitmcp.io/{owner}/{repo}
• GitHub Pages siteleri için: {owner}.gitmcp.io/{repo}
• Herhangi bir repository'yi destekleyen genel bir araç için (dinamik): gitmcp.io/docs

{owner} yerine GitHub kullanıcı adı veya organizasyon adını, {repo} yerine repository adını yazın.

Kolaylık olması açısından, GitHub URL'sini bir MCP URL'sine biçimlendirmek için landing page'deki dönüşüm aracını da kullanabilirsiniz!

Adım 2: AI asistanınızı bağlayın

Aşağıdaki seçeneklerden AI asistanınızı seçin ve yapılandırma talimatlarını izleyin:

Cursor'u Bağlama

Cursor yapılandırma dosyanızı ~/.cursor/mcp.json adresinde güncelleyin:

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Claude Desktop'u Bağlama

1. Claude Desktop'ta Settings > Developer > Edit Config'e gidin
2. Yapılandırmayı şu şekilde değiştirin:

   {
     "mcpServers": {
       "gitmcp": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://gitmcp.io/{owner}/{repo}"
         ]
       }
     }
   }
   

Windsurf'u Bağlama

Windsurf yapılandırma dosyanızı ~/.codeium/windsurf/mcp_config.json adresinde güncelleyin:

{
  "mcpServers": {
    "gitmcp": {
      "serverUrl": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

VSCode'u Bağlama

VSCode yapılandırma dosyanızı .vscode/mcp.json adresinde güncelleyin:

{
  "servers": {
    "gitmcp": {
      "type": "sse",
      "url": "https://gitmcp.io/{owner}/{repo}"
    }
  }
}

Cline'ı Bağlama

Cline yapılandırma dosyanızı ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json adresinde güncelleyin:

{
  "mcpServers": {
    "gitmcp": {
      "url": "https://gitmcp.io/{owner}/{repo}",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Highlight AI'ı Bağlama

1. Highlight AI'ı açın ve kenar çubuğundaki plugins simgesine (@ sembolü) tıklayın
2. Kenar çubuğunun en üstünde Installed Plugins'e tıklayın
3. Custom Plugin'i seçin
4. Add a plugin using a custom SSE URL'ye tıklayın

Plugin adı: gitmcp SSE URL: https://gitmcp.io/{owner}/{repo}

HighlightAI'ına özel MCP sunucuları ekleme hakkında daha fazla ayrıntı için dokümantasyona bakın.

Augment Code'u Bağlama

1. Augment Code ayarlarını açın
2. MCP bölümüne gidin
3. Aşağıdaki ayrıntılarla yeni bir MCP sunucusu ekleyin:

MCP sunucusunu adlandırın: git-mcp Docs

Bu komutu kullanın:

npx mcp-remote https://gitmcp.io/{owner}/{repo}

Veya aşağıdaki yapılandırmayı kullanın:

{
  "mcpServers": {
    "git-mcp Docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Msty AI'ı Bağlama

1. Msty Studio'yu açın
2. Tools > Import Tools from JSON Clipboard'a gidin
3. Aşağıdaki yapılandırmayı yapıştırın:

{
  "mcpServers": {
    "git-mcp Docs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://gitmcp.io/{owner}/{repo}"
      ]
    }
  }
}

Augment Code'da MCP sunucularını yapılandırma hakkında daha fazla ayrıntı için Augment Code dokümantasyonunu ziyaret edin.

Not: {owner} ve {repo} yerine gerçek GitHub kullanıcı adı/organizasyonu ve repository adını yazın. Ayrıca AI'ınızın her istekte gerekli olduğunda herhangi bir repository'ye erişmesine izin vermek için dinamik endpoint https://gitmcp.io/docs'ı kullanabilirsiniz.

⚙ Nasıl Çalışır

GitMCP, AI asistanınızı Model Context Protocol (MCP) kullanarak GitHub repositories'e bağlar; MCP, AI araçlarının harici kaynaklardan ek bilgi talep etmesini sağlayan bir standarttır.

GitMCP'yi kullandığınızda neler olur:

1. GitMCP URL'sini AI asistanınıza sağlarsınız (ör. gitmcp.io/microsoft/typescript). GitMCP dokümantasyon getirme, akıllı arama, kod arama vb. gibi araçları ortaya çıkarır.
2. AI asistanını dokümantasyon/kod ile ilgili sorularla yönlendirir.
3. AI asistanınız istekleri GitMCP'ye gönderir (onayınızla).
4. GitMCP isteği yürütür ve istenen verileri döndürür.
5. AI asistanınız bilgiyi alır ve hallüsinasyon olmadan daha doğru ve temelli bir cevap üretir.

Desteklenen Dokümantasyon

GitMCP şu anda aşağıdaki belgeleri destekler (öncelik sırasına göre):

1. llms.txt
2. Projenin dokümantasyonunun AI-optimized versiyonu
3. README.md/root

💡 Örnekler

Farklı AI asistanları ve repositories'ler ile GitMCP'nin nasıl kullanılacağına dair örnekler:

Örnek 1: Windsurf'u belirli bir repository ile kullanma

GitHub repository'si https://github.com/microsoft/playwright-mcp için, https://gitmcp.io/microsoft/playwright-mcp'yi Windsurf'a MCP sunucusu olarak ekleyin.

Claude'a Sorgu:

"How do I use the Playwright MCP"

Windsurf, GitMCP'den bellek özelliğini doğru bir şekilde uygulamak için ilgili dokümantasyonu çeker.

Örnek 2: Cursor'u GitHub Pages sitesiyle kullanma

GitHub Pages sitesi langchain-ai.github.io/langgraph için, https://langchain-ai.gitmcp.io/langgraph'ı Cursor'a MCP sunucusu olarak ekleyin.

Cursor'a Sorgu:

"Add memory to my LangGraph agent"

Cursor, GitMCP'den ilgili dokümantasyon ve kodu çeker ve bellek özelliğini doğru bir şekilde uygular.

Örnek 3: Claude Desktop'u dinamik endpoint ile kullanma

Belirli repositories'leri seçmek zorunda değilsiniz. Genel gitmcp.io/docs endpoint'i AI'ın GitHub projesini anında seçmesine izin verir!

Herhangi bir AI asistana Sorgu:

"I want to learn about the OpenAI Whisper speech recognition model. Explain how it works."

Claude, GitMCP'den verileri çeker ve soruyu cevaplar.

🛠️ Araçlar

GitMCP, AI asistanlarına GitHub repositories'lerine erişmesine, anlamasına ve sorgu yapmasına yardımcı olmak için çeşitli değerli araçlar sağlar.

fetch_<repo-name>_documentation

Bu araç bir GitHub repository'sinden birincil dokümantasyonu getirir. llms.txt gibi ilgili dokümantasyonu alarak çalışır. Bu, AI'ya projenin ne hakkında olduğunun iyi bir genel bakışını verir.

Ne zaman kullanışlı: Bir projenin amacı, özellikleri veya nasıl başlanacağına ilişkin genel sorular için

search_<repo-name>_documentation

Bu araç, AI'ın belirli bir arama sorgusu sağlayarak repository'nin dokümantasyonunu arama yapmasını sağlar. Tüm dokümantasyonu yüklemek (çok büyük olabilir) yerine akıllı arama kullanarak sadece ilgili kısımları bulur.

Ne zaman kullanışlı: Bir proje içindeki belirli özellikler, işlevler veya kavramlar hakkında spesifik sorular için

fetch_url_content

Bu araç AI'ın dokümantasyonda belirtilen bağlantılardan bilgi almasına yardımcı olur. Bu bağlantılardan içeriği alır ve AI'ın kolayca okuyabileceği bir formata dönüştürür.

Ne zaman kullanışlı: Dokümantasyon sorunuzu cevaplamanıza yardımcı olacak harici bilgileri referans gösteriyor

search_<repo-name>_code

Bu araç, GitHub'ın kod arama özelliğini kullanarak repository'deki gerçek kodu arar. AI'ın belirli kod örnekleri veya uygulama ayrıntılarını bulmasına yardımcı olur.

Ne zaman kullanışlı: Bir şeyin nasıl uygulandığına dair örnekler istediğinizde veya dokümantasyonda kapsanmayan teknik ayrıntılara ihtiyaç duyduğunuzda

Not: Dinamik endpoint (gitmcp.io/docs) kullanırken, bu araçlar biraz farklı şekilde adlandırılır (fetch_generic_documentation, search_generic_code ve search_generic_documentation) ve hangi repository'ye erişileceğine dair ek bilgi gerektirir.

📊 Badge

GitMCP, repository'nizin README'si için bir badge'i vardır. Kullanıcıların dokümantasyonunuza IDE veya tarayıcı aracılığıyla (gömülü sohbet kullanarak) hızlıca erişmesine izin verir. Ayrıca dokümantasyonunuzun GitMCP aracılığıyla kaç kez erişildiğini gösterir.

Örnek (idosal/git-mcp):

Badge'i Repository'nize Ekleme

README.md dosyanıza aşağıdakini ekleyin:

[![GitMCP](https://img.shields.io/endpoint?url=https://gitmcp.io/badge/OWNER/REPO)](https://gitmcp.io/OWNER/REPO)

OWNER yerine GitHub kullanıcı adınız veya organizasyonunuzu, REPO yerine repository adınızı yazın.

Görüntülemeleri Nasıl Sayıyoruz

Belirli repository üzerindeki her araç çağrısı için artırırız.

Badge'i Özelleştirme

Badge'in görünümünü parametrelerle özelleştirebilirsiniz:

Parametre	Açıklama	Varsayılan	Örnek
color	Badge değeri için renk	aquamarine	?color=green
label	Badge etiketi	GitMCP	Documentation

Yardıma ihtiyacınız olursa lütfen bize ulaşın!

❓ SSS

Model Context Protocol Nedir?

Model Context Protocol, AI asistanlarının harici kaynaklardan yapılandırılmış bir şekilde ek bağlam talep etmesine ve almasına izin veren, böylece anlayışlarını ve performanslarını geliştiren bir standarttır.

GitMCP herhangi bir AI asistanı ile çalışır mı?

Evet, GitMCP, Model Context Protocol'ü destekleyen herhangi bir AI asistanı ile uyumludur; Cursor, VSCode, Claude vb. araçları içerir.

GitMCP tüm GitHub projeleriyle uyumlu mu?

Kesinlikle! GitMCP, herhangi bir değişiklik gerektirmeksizin herhangi bir genel GitHub repository'siyle çalışır. llms.txt dosyasını öncelik verir ve eğer kullanılamıyorsa README.md veya diğer sayfalara geri döner. Gelecek güncellemeler ek dokümantasyon yöntemlerini ve hatta dinamik olarak içerik üretmeyi desteklemeyi amaçlamaktadır.

GitMCP'nin maliyeti var mı?

Hayır, GitMCP topluluğun hizmet vermek için ücretsizdir ve ilişkili bir maliyet yoktur.

🔒 Gizlilik

GitMCP, kullanıcılarının gizliliğine derin bir şekilde bağlıdır. Hizmet kimlik doğrulama gerektirmediği için kişisel olarak tanımlanabilir bilgilere erişim olmaz veya bunları depolar. Buna ek olarak, aracılar tarafından gönderilen sorgularını saklamaz. Ayrıca, GitMCP açık kaynaklı bir proje olduğu için bağımsız olarak ortamınızda dağıtılabilir.

GitMCP sadece halihazırda kamuya açık olan içeriğe ve yalnızca kullanıcı tarafından sorgulandığında erişir. GitMCP repository'leri otomatik olarak taramaz. Herhangi bir GitHub Pages sitesine erişmeden önce, kod robots.txt kurallarını kontrol eder ve site sahipleri tarafından belirlenen yönergeleri izler; bu da onların geri çekilmesine izin verir. GitMCP'nin GitHub projeleri veya içerikleri hakkında verileri kalıcı olarak saklamadığını lütfen unutmayın.

👥 Katkıda Bulunma

Katkıları, geri bildirimleri ve fikirleri memnuniyetle karşılarız! Lütfen katkı yönergelerimizi gözden geçirin.

Yerel Geliştirme Kurulumu

1. Repository'yi klonlayın

   git clone https://github.com/idosal/git-mcp.git
   cd git-mcp
   

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

   pnpm install
   

3. Geliştirme için yerel olarak çalıştırın

   npm run dev
   # veya
   pnpm dev
   

Test için MCP Inspector'ü Kullanma

1. MCP Inspector aracını yükleyin:

   npx @modelcontextprotocol/inspector
   

2. İnspektör arayüzünde:

   • Transport Type'ı SSE olarak ayarlayın
   • GitMCP URL'nizi girin (ör. http://localhost:5173/docs)
   • "Connect"'e tıklayın

📄 Lisans

Bu proje Apache License 2.0 altında lisanslanmıştır.

Sorumluluk Reddi

GitMCP herhangi bir garanti olmaksızın "olduğu gibi" sağlanır. Hizmetimizin güvenilirliğini ve güvenliğini sağlamak için çalışırken, kullanımından kaynaklanabilecek herhangi bir hasar veya sorundan sorumlu değiliz. GitMCP aracılığıyla erişilen GitHub projeleri ilgili sahiplerinin şartlarına ve koşullarına tabidir. GitMCP, GitHub veya bahsedilen AI araçlarından hiçbiriyle bağlantılı değildir.

Yıldız Geçmişi