Context7 vs Grounded Docs MCP Server

Context7 ne zaman seçilir

• Ajanınızın ihtiyaç duyduğu kütüphane hazır indekste bulunuyorsa ve dokümantasyonu kendiniz taramak istemiyorsanız Context7 seçin. Ajan önce kütüphane adını bir kimliğe dönüştürür, ardından kodlama sorusuna yönelik dokümantasyon bölümlerini getirir.
• Kullandığınız API'nin davranışı sürüme bağlıysa tercih edin. İstekte kütüphane sürümünü belirttiğinizde Context7 uygun dokümantasyonla eşleştirir. Böylece ajanınıza yalnızca paket adını vermek yerine hangi sürüm için yanıt aradığınızı da belirtmiş olursunuz.
• Kütüphanenin Context7 kimliğini zaten biliyorsanız kullanın. Örneğin /supabase/supabase kimliğini isteğe eklemek, kütüphane eşleştirme adımını atlayıp doğrudan dokümantasyon sorgusuna geçmenize olanak tanır.
• MCP bağlantısını barındırılan bir uç noktaya yönlendirmek istiyorsanız seçin. Context7, yerel stdio sunucusunun yanında uzak bağlantı seçeneği sunar. Kurulum komutunda kodlama ajanınız için MCP modunu seçebilirsiniz.

Grounded Docs MCP Server ne zaman seçilir

• Kaynaklarınız arasında şirket içi SDK dosyaları, yerel klasörler veya arşivler varsa Grounded Docs MCP Server seçin. Web siteleri, GitHub depoları, npm ve PyPI paketlerini de indeksleyerek projenizin başvuracağı kaynakları kendiniz belirleyebilirsiniz.
• Farklı sürümlerin dokümantasyonunu ayrı ayrı tutmanız gerekiyorsa tercih edin. Tarama sırasında sürümü siz adlandırırsınız; aramalar bu sürümü hedefleyebilir. İndeksin ne zaman güncelleneceğine veya baştan oluşturulacağına da siz karar verirsiniz.
• Başvuru dosyalarınız PDF, Office, OpenDocument, EPUB veya Jupyter notebook biçimindeyse kullanın. Sunucu bu dosyaları Markdown, HTML ve kaynak koduyla birlikte işleyebilir. Bu, dokümantasyon koleksiyonunuzun yalnızca web sayfalarından oluşmadığı durumlara uygundur.
• İndeks oluşturmayı betiklere eklemek istiyorsanız seçin. CLI, sunucu çalışmadan tarama ve arama yapabilir; aynı makinedeki sunucuyla ortak veritabanını kullanır. Sözcük eşleşmesinin yanında anlama göre arama da istiyorsanız isteğe bağlı vektör aramasını açabilirsiniz.

Temel farklar

• İndeksi kimin yönettiği farklıdır. Context7 kendi kütüphane indeksini sorgular; API arka ucu, ayrıştırıcısı ve tarayıcısı MCP deposunun dışındaki kapalı bileşenlerdir. Grounded Docs indeksleyiciyi sizin makinenizde çalıştırır ve indeksi yerel SQLite veritabanında tutar.
• İkisi de sürüme özel dokümantasyon sunar. Context7, istekte belirttiğiniz sürümü eşleştirir. Grounded Docs sürümleri ayrı saklar; mevcut içeriği refresh ile günceller, --replace ile yeniden oluşturursunuz. İkinci yaklaşımda tarama ve güncelleme işini siz yönetirsiniz.
• Bağlantı seçenekleri kısmen örtüşür. Context7 yerel stdio veya barındırılan uç nokta üzerinden çalışır. Grounded Docs için yukarıdaki tabloda yalnızca stdio yazsa da README, Streamable HTTP bağlantısını ve yerel HTTP uç noktasını da belgeler.
• Anahtarların amacı farklıdır. Context7 daha yüksek istek sınırları için ücretsiz API anahtarı önerir; elle yapılandırılan uzak bağlantıda bearer kimlik doğrulamasını belgeler. Grounded Docs varsayılan olarak kimlik doğrulaması istemez. Belgelerinde OAuth2/OIDC ile koruma ve isteğe bağlı embedding sağlayıcısı kimlik bilgileri de yer alır.
• Yerel indeks, tüm verilerin makinede kalacağı anlamına gelmez. Context7'nin barındırılan bağlantısında dokümantasyon sorguları hizmete gider. Grounded Docs belge metnini yapılandırdığınız embedding sağlayıcısına gönderir; Ollama gibi yerel bir sağlayıcıyla metin makinede kalır. Kullanım telemetrisi varsayılan olarak açıktır.
• Araçların kapsamı farklıdır. Context7, kütüphaneyi bulmak ve dokümantasyon getirmek için resolve-library-id ve query-docs araçlarını sunar. Grounded Docs, koleksiyon oluşturma, güncelleme ve arama işleri için MCP arayüzünün yanında web arayüzü ve CLI komutları içerir.

Kurulum

Context7: yerel MCP sunucusunu npx -y @upstash/context7-mcp ile başlatın veya npx ctx7 setup komutunda MCP modunu seçin. Kurulum akışı OAuth üzerinden kimlik doğrular ve API anahtarı oluşturur. Uzak bağlantıyı elle yapılandırırken https://mcp.context7.com/mcp adresini ve Authorization: Bearer YOUR_API_KEY başlığını kullanın.

Grounded Docs MCP Server: npx @arabold/docs-mcp-server@latest ile başlatın, http://localhost:6280 adresindeki web arayüzünden dokümantasyon ekleyin ve istemcinizi http://localhost:6280/mcp adresine bağlayın. Vektör araması kullanacaksanız embedding modelini belgeleri indekslemeden önce yapılandırın. Model olmadan indekslenen belgelere vektör eklemek için --replace ile yeniden tarama gerekir.