MCP Araçları

Arama ve erişim

Anahtar kelime, desen veya anlam açısından şeyler bulan araçlar.

searchAxonExamples

İndeksli Axon kodu üzerinde anahtar kelime araması. Kategori ve etiket filtreleri destekler. Alaka düzeyi puanı ve kısa bir parça ile en iyi eşleşmeleri döndürür.

searchAxonOperatorExamples

Özellikle operatör kullanımını ara — >=, ==, + vb. geçin ve sunucu operatörün bağlam içinde kullanıldığı gerçek örnekler döndürür.

searchAxonDocs

HTML ve Markdown dokümantasyon ağacı üzerinde FlexSearch. ~50 ms sorgu süresi; sonuçlar başlık hiyerarşisini ve alıntılanmış parçaları içerir.

searchAxonRegex

kod içinde grep tarzı regex araması. Eşleşen satırları çevresinde N satırla döndürür (yapılandırılabilir).

listAxonCategories / listAxonPatterns / getAxonPattern / getAxonExample

Kategoriye göz atın veya belirli bir işlevi ID veya adla alın.

İşlev analizi

İşlevlerin birbirleriyle nasıl ilişkili olduğunu mantık yürüten araçlar.

findFunctionUsage

Belirli bir işlev için her çağrı noktası, dosya yolu ve satır numarası ile.

getFunctionExamples

İndeksli kod tabanından alınan gerçek dünya kullanım örnekleri — işlevin kendi dokümantasyonu yetersiz olduğunda kullanışlıdır.

getFunctionCallGraph

Bir işlevte kök olan çağrıcı/çağrılacak grafik, yapılandırılabilir derinliğe kadar.

getFunctionUsageStats

Kod tabanı üzerinde kullanım sayıları. Kullanılmayan işlevler, aşırı kullanılan işlevler ve bağlantı metrikleri.

Kod oluşturma ve doğrulama

Kodu yazan ve kontrol eden araçlar.

generateAxonCode

Şablon tabanlı oluşturma. 33 küratörlü YAML şablonu HVAC dizileri, enerji hesaplamaları, arıza tespiti ve veri toplamayı kapsar. Çıkış, döndürülmeden önce doğrulanır.

validateAxonCode

Üç geçiş çalıştırır: anlamsal kontrol (ayrıştırılıyor mu? tanımlayıcılar geçerli mi?), performans analizi ve en iyi uygulamalar linting'i.

parseAxonAst

Bir Axon ifadesini AST'ye ayrıştırın. Sunucu üstünde daha yüksek düzey araçlar oluşturmak için yararlıdır.

executeAxonCode

Birincil SkySpark projesi karşısında bir Axon ifadesini değerlendirin. Sonucu Haystack ızgara JSON'i olarak döndürür.

commitAxonFunction

Birincil projeye bir işlev işleyin. functionVersioning açıkken, önceki revizyon korunur.

SkySpark entegrasyonu

Canlı bir SkySpark örneği ile konuşmak için araçlar.

queryHaystack

Bir Haystack sorgusu (read, readAll, history vb.) yürütün ve sonuç ızgarasını döndürün.

listSkySparkProjects / switchSkySparkProject

Yapılandırılan örneğindeki projeleri numaralandırın ve sonraki çağrılar için etkin proje bağlamını değiştirin.

discoverProjectFunctions / discoverInstanceProjects

Örneğin yapılandırılan projelerini dolaşın, kullanıcı tanımlı işlevlerini yerel dizine senkronize edin ve aranabilir hale getirin.

getProjectSchema

Bir projeye ait Haystack şemasını (etiketler, işaretler, tanımlanan türler) döndürün.

setPrimaryProject / getPrimaryProject

executeAxonCode ve commitAxonFunction tarafından kullanılan birincil proje bağlamını yönetin.

Grafik analizi ve benzerlik

Kod grafı ve vektör yerleştirme deposu üzerine inşa edilen araçlar.

getCallers / getCallees

Çağrı grafiğinde doğrudan komşular — kim X'i çağırıyor ve X'in neyi çağırdığı.

getCodeImpact

Blast-radius analizi. Bir işlev verildiğinde, buna yapılan bir değişiklik tarafından etkilenecek her aşağı yönlü işlev döndürün.

findCodePath

İki işlev arasında en kısa çağrı yolu. Bir yaprak işlevin giriş noktasından nasıl ulaştığını izlemek için kullanışlıdır.

semanticCodeSearch

Kodu anlamına göre döndüren doğal dil sorguları. "Günlük enerji sayaçlarını gece yarısında sıfırlayan herhangi bir şeyi bul" hiçbir kod bu kelimeleri tam anlamıyla içermese bile çalışır.

findSimilarCode

Sağlanan bir kod parçası ile indeksli kod tabanı arasında vektör benzerliği. Çoğaltma ve yeniden düzenleme keşfi için kullanışlıdır.

getGraphMetrics / getMostCalledFunctions / getMostComplexFunctions

Arasalık merkezliği, bağlantı puanları, karmaşıklık sıralamaları.

buildProjectGraph / buildProjectEmbeddings / getGraphStats

İndeksleri yeniden oluşturmak ve incelemek için bakım araçları.

detectCycles

Çağrı grafı üzerinde dairesel bağımlılık tespiti.

Hata işleme kuralları

Tüm araçlar başarısızlıkta atmak yerine yapılandırılmış bir hata döndürür. Hata gövdesi code (ör. INDEX_NOT_FOUND, SKYSPARK_UNREACHABLE, INVALID_ARGUMENT) ve insan tarafından okunabilir bir message içerir. İstemciler code'u son kullanıcılara sunmalı ve message'ı hata ayıklama için günlüğe kaydetmelidir.