İçeriğe atla

Seçim rehberi

Kod zekası MCP sunucusu nasıl seçilir

Ajanınızın kendi kodunuz hakkında sorduğu gerçek sorulara yanıt veren sunucuyu seçin: bir sembol nerede tanımlanmış, onu kim çağırıyor, değişirse ne bozulur ve adını artık kimsenin hatırlamadığı bir kavram nerede duruyor.

Bunun için birkaç farklı arama türü, ürününüzde kullandığınız diller için gerçek ayrıştırma, commit'lerinize yetişen bir indeks ve istemcinizin birkaç dakikada tamamlayabileceği bir kurulum gerekir. Aşağıdaki 15 dakikalık testi iyi bildiğiniz bir repoda yapın: bu liste dahil, her özellik listesinden daha değerlidir.

Neleri karşılaştırmalı

Her adaya aynı soruları sorun, sonra yanıtları kendi kodunuzda doğrulayın. Özellik listesi bir iddiadır; reponuzda verilen doğru yanıt ise kanıttır.

Ölçüt Ne sormalı Nasıl doğrulanır
Arama modları Anlamsal, yapısal (AST), graf ve tam metin aramayı bir araya getiriyor ve her soruyu doğru moda yönlendiriyor mu? Tek bir mod, bütün soru sınıflarını yanıtsız bırakır. Her türden bir soru sorun: bir kavram, bir kod biçimi, bir çağıran listesi ve birebir bir hata mesajı.
Dil desteğinin derinliği Ürününüzde kullandığınız her dilde kod, semboller ve ilişkilerle birlikte bir AST'ye mi ayrıştırılıyor, yoksa yalnızca metin olarak mı indeksleniyor? Uzun bir dil listesi yüzeysel desteği gizleyebilir. Dilleriniz için yayımlanmış yetenek işaretlerini bulun, sonra her birinde bir sembol arayın.
Repo ölçeği En büyük reponuzu ve aynı anda birkaç repoyu kaldırabiliyor mu? Sonuçlar sıralı ve sınırlı mı kalıyor, yoksa tek bir büyük dosya yanıtı mı dolduruyor? Bir demo projesini değil, gerçek en büyük reponuzu indeksleyin ve ilk işe yarar yanıta kadar geçen süreyi ölçün.
Güncellik ve eşitleme İndeks yeni commit'lerden nasıl haberdar oluyor ve bir değişikliğin aranabilir hâle gelmesi ne kadar sürüyor? Eski bir indeks, artık var olmayan kod hakkında kendinden emin yanıtlar verir. Bir yeniden adlandırmayı commit'leyin, sonra hem yeni hem eski adı arayın.
Güvenlik ve veri işleme Kaynak kodunuz nerede saklanıyor, üçüncü taraflara ne gönderiliyor, eğitim için kullanılıyor mu ve bağlantıyı kestiğinizde ne siliniyor? Veri işleme sayfasını okuyun. Rozetlere değil, adı verilen sağlayıcılara ve somut silme kurallarına bakın.
İstemci başına kurulum Ekibinizin kullandığı her istemci için belgelenmiş bir yapılandırma var mı ve tek bir uç nokta hepsine hizmet veriyor mu? Ekibinizin zaten kullandığı iki istemciyi bağlayın ve ikisinin süresini de ölçün.
Fiyatlandırma modeli Fiyat herkese açık mı? Koltuk, ajan ya da çalışma alanı başına mı ödüyorsunuz ve ücretsiz katman gerçek bir deneme için yeterli mi? Gerçek kurulumunuzu fiyatlandırın: gerçekten çalıştıracağınız ajanlar, repolar ve indekslenmiş satırlar.
Kendi kodunuzda kanıt Bugün, satış görüşmesi yapmadan kendi reponuzda test edebiliyor musunuz? Deneme için önce toplantı gerekiyorsa, bu da bir yanıttır.

İndeksin nerede durduğu

İndeksin nerede durduğu, neyi yanıtlayabildiğinden daha az önemlidir. Ajanınız bir düzenlemeyi planladığı anda doğru dosyaya, sembole ve çağıran listesine ihtiyaç duyar; bu yüzden her adayı yukarıdaki sorularla, kendi kodunuz üzerinde değerlendirin.

15 dakikada kendi reponuzda test edin

Her yanıtı bir bakışta puanlayabilmek için iyi bildiğiniz bir repo kullanın. Düzeltmek zorunda kaldığınız yanıtları sayın.

  1. Repoyu bağlayın ve ilk aramanın sonuç döndürmesinin ne kadar sürdüğünü not edin.

  2. Kodla hiçbir anahtar kelimeyi paylaşmayan kavramsal bir soru sorun; örneğin "süresi dolmuş oturumları nerede ele alıyoruz?" Alıntılanan her dosyayı ve satırı açın.

  3. Bir sembolü adıyla arayın, sonra onu çağıranları sorun. Listeyi bildiklerinizle karşılaştırın.

  4. Değiştirmeyi planladığınız bir fonksiyon seçin ve ona neyin bağımlı olduğunu sorun. Bu liste onun etki yarıçapıdır: bir bozulmayı yakalayacak testlerle karşılaştırın.

  5. Ad yerine bir kod biçimi sorun; örneğin tüm rota işleyicileri ya da belirli bir arayüzü uygulayan tüm sınıflar.

  6. Bir hata mesajı gibi birebir bir dizgeyi arayın ve her eşleşmenin gerçek olduğunu doğrulayın.

  7. Küçük bir yeniden adlandırmayı commit'leyin, indeksin yetişmesini bekleyin ve iki adı da arayın.

  8. Düzeltmeleri sayın. Özellik listesi ne derse desin, en az düzeltme gerektiren sunucu kazanır.

Terimler ve tanımları

Kod zekası MCP sunucusu
Kaynak kodu indeksleyen ve yapay zeka ajanlarına araç olarak sunan bir MCP sunucusu. Ajan, dosyaların tamamını isteme yapıştırmak yerine bir soru sorar ve dosya yolları ile satır numaraları içeren sıralı sonuçlar alır.
Kod grafı
Sembollerin, dosyaların ve modüllerin nasıl bağlandığını gösteren bir harita: tanımlar, referanslar, çağrılar, içe aktarmalar ve kalıtım. Her dosyayı okumadan "bunu kim kullanıyor?" sorusunu yanıtlar.
Etki yarıçapı
Bir sembol değiştiğinde etkilenebilecek kod: onu çağıranlar, ona bağımlı olanlar ve bunları kapsayan testler. Bunu bir düzenlemeden önce bilmek, graf aramanın tam olarak amacıdır.
AST araması
Soyut sözdizimi ağacı, yani kodun ayrıştırılmış yapısı üzerinde arama. Kodu biçimine göre bulur; örneğin belirli bir dekoratöre sahip tüm fonksiyonlar. Düz metin araması bunu güvenilir biçimde yapamaz.
Anlamsal arama
Embedding'ler kullanarak anlama göre arama. Kod ile soru tek bir kelimeyi bile paylaşmasa da bir açıklamaya uyan kodu bulur.
Tam metin araması
Değişmez değer ya da düzenli ifade ile eşleştirme. Hata mesajları, yapılandırma anahtarları ve zaten bildiğiniz tanımlayıcılar için doğru araçtır.

Maguyva nereye oturuyor

Maguyva, barındırılan bir kod zekası MCP sunucusudur. Bağladığınız GitHub repolarını indeksler ve ajanınıza 11 MCP aracı sunar; her sonuç dosya yoluyla birlikte gelir.

Arama
Anlamsal, yapısal, graf ve tam metin araması; ayrıca sembol arama ve her soru için doğru modu seçen bir yönlendirici araç.
  • intelligent_search
  • semantic_search
  • structural_search
  • text_pattern_search
  • find_symbol
  • dependency_search
  • analyze_dependencies
Diller
285 dil ve metin biçimi indeksleniyor: 247 tanesinde AST tabanlı yapısal arama, 282 tanesinde sembol çıkarma ve 151 tanesinde graf ilişkileri var. Derinlik dile göre değişir, kendi dillerinizi kontrol edin.
Güncellik
Kod değiştikçe indeksler GitHub eşitleme işleriyle yenilenir.
Kurulum
Tek bir uzak MCP uç noktası ve belgelenmiş 23 istemci için adım adım yapılandırmalar.
Fiyatlandırma
Herkese açık; koltuk başına değil, çalışma alanı başına. Free planı 3 repo ve 50.000 indekslenmiş satırı kapsar; 15 dakikalık test için yeterlidir.
Veri işleme
Neyin nerede saklandığı, embedding için neyin gönderildiği ve bağlantıyı kestiğinizde neyin silindiği güvenlik sayfasında yazıyor.

Repolar şu anda GitHub üzerinden bağlanıyor. Kodunuz başka bir yerdeyse, başlamadan önce uyumluluk sayfasına bakın.

// en iyi benchmark, zaten tanıdığınız bir repo.