codegraph: AI modellerine yapılandırılmış kod bağlamı veren yerel bir MCP sunucusu
codegraph, Isink17'den, büyük havuzların AI anlayışını geliştirmek için kaynak kodunun yapılandırılmış grafik temsillerini sağlar. Projeleri tree-sitter ile ayrıştırır, sembolleri ve çağrı grafiklerini indeksler ve AI kod asistanları için MCP istemcilerine Model Bağlam Protokolü sunucusu üzerinden ilişkisel bağlam sağlar. Çok dilli ayrıştırmayı, anlamsal proje genelinde aramayı, MCP bağlantısını ve kodun geliştiricinin makinesinde kalmasını sağlamak için yerel yürütme ve çağrı-grafiği çıkarımını destekler. Yanlış kod çıkarımlarını azaltmak için kesin yapısal bağlama ihtiyaç duyan AI asistanlarını kullanan mühendisler için inşa edilmiştir.
Kaynak ağaçlarını sorgulanabilir bir ilişkisel grafiğe dönüştürür
Aracın arama yapılabilir bir indeks oluşturur ve bu, ham dosya metni döndürmek yerine işlevler, sınıflar ve değişkenler arasındaki ilişkileri haritalar. O grafik tabanlı indeks, çağrı grafiklerini ve içe aktarma hiyerarşilerini içerir ve bu ilişkileri bir MCP sunucu arayüzü aracılığıyla açığa çıkarır. Kullanıcılar için, hemen elde edilen sonuç, bir asistanın sembol tanımları, referanslar ve tüm depo genelindeki karşılıklı bağımlılıklar için sorgulayabileceği gezilebilir bir yapıdır.
Ayrıştırma doğruluğu, anahtar kelime aramasına kıyasla model odaklı analizi geliştirir
codegraph, sözdizim ağaçlarını ve kesin sembol konumlarını çıkarmak için tree-sitter ayrıştırıcılarını kullanır, bu da modelin üzerinde akıl yürütebileceği yapılandırılmış düğümler üretir. Tanımları ve referansları haritaladığı için, araç AI istemcilerinin basit anahtar kelime uyuşmazlıklarından kaçınmasına yardımcı olur ve kod akışı hakkında yanlış çıkarımları azaltır. Anlamsal proje genelindeki arama, izleme bilgilere sahip sonuçlar döndürür, bu da yeniden yapılandırma ve dosyalar arası etki analizine fayda sağlar.
Dağıtım, belirli girdiler ve MCP uyumlu bir istemci gerektirir
Sunucu, bir Node.js ortamında çalışır ve girdi olarak bir kaynak dosyası dizini kabul eder, ayrıştırma için tree-sitter dil gramerlerine dayanır. Claude Desktop gibi MCP uyumlu istemcilerle uyumludur ve MCP yapılandırma girişleri veya npx ile başlatılan bir yapı aracılığıyla bağlanır. Desteklenen diller arasında TypeScript, JavaScript, Python ve diğer tree-sitter kapsamındaki diller bulunur, bu nedenle dil kapsamı mevcut ayrıştırıcılara bağlıdır.
Yerel yürütme, depo gizliliğini korur ancak operasyonel yük ekler
codegraph, yerel makinede grafik inşası gerçekleştirir ve kodu harici hizmetlere yüklemez, bu model kaynak verilerini özel tutarken sonuçta elde edilen grafiği yerel bir AI istemcisine sağlar. Bu tasarım, hassas kod tabanları için uygundur ancak geliştiricilerin yerel bir sunucuyu çalıştırması ve sürdürmesi, Node.js'i kullanılabilir durumda tutması ve faydaları görmeden önce iş akışlarına MCP uyumlu bir asistan entegre etmesi gerekir.
Model-bilgilendirilmiş bağlamı geliştirme iş akışlarına entegre eden ekipler için pratik
codegraph, AI destekli kod analizi için yapılandırılmış model bağlamına ihtiyaç duyan geliştiriciler için sağlam bir seçenektir. Makine üzerindeki ilişkisel bağlamı sunmaya odaklanması, ekiplerin yerel bir Node.js sunucusu sağlaması ve değer elde etmek için MCP uyumlu bir asistan ile eşleştirmesi gerektiği anlamına gelir. Yapısal bağlamın basit anahtar kelime aramalarından daha önemli olduğu depolar için, bu araç AI destekli geliştirme iş akışlarına pratik bir iyileştirme sunar.
