MCP-Tools

Suche und Abruf

Tools, die Dinge nach Schlüsselwort, Muster oder Bedeutung finden.

searchAxonExamples

Schlüsselwortsuche über indexierten Axon-Code. Unterstützt Kategorie- und Tag-Filter. Gibt die Top-Treffer mit Relevanzwertung und kurzem Snippet zurück.

searchAxonOperatorExamples

Suche speziell nach Operatorverwendung — übergeben Sie >=, ==, + usw., und der Server gibt echte Beispiele zurück, in denen der Operator im Kontext verwendet wird.

searchAxonDocs

FlexSearch über den HTML- und Markdown-Dokumentationsbaum. ~50 ms Abfragezeit; Ergebnisse enthalten Überschriftenhierarchie und Auszüge.

searchAxonRegex

grep-ähnliche Regex-Suche im Code. Gibt passende Zeilen mit N Zeilen umgebenden Kontext zurück (konfigurierbar).

listAxonCategories / listAxonPatterns / getAxonPattern / getAxonExample

Durchsuchen Sie nach Kategorie oder rufen Sie eine bestimmte Funktion nach ID oder Name ab.

Funktionsanalyse

Tools, die analysieren, wie Funktionen zueinander in Beziehung stehen.

findFunctionUsage

Jede Aufrufstelle für eine bestimmte Funktion mit Dateipfad und Zeilennummer.

getFunctionExamples

Echte Nutzungsbeispiele aus der indexierten Codebasis — hilfreich, wenn die eigene Dokumentation einer Funktion dünn ist.

getFunctionCallGraph

Der Aufrufer-/Aufgerufenen-Graph mit Wurzel bei einer Funktion, bis zu konfigurierbarer Tiefe.

getFunctionUsageStats

Nutzungszahlen über die Codebasis. Ungenutzte Funktionen, übernutzte Funktionen und Kopplungsmetriken.

Codegenerierung und Validierung

Tools, die Code schreiben und überprüfen.

generateAxonCode

Template-gesteuerte Generierung. 33 kuratierte YAML-Templates decken HLK-Sequenzen, Energieberechnungen, Fehlererkennung und Datenaggregation ab. Die Ausgabe wird vor der Rückgabe validiert.

validateAxonCode

Führt drei Durchläufe aus: semantische Überprüfung (wird es geparst? sind Bezeichner gültig?), Leistungsanalyse und Best-Practices-Linting.

parseAxonAst

Parse einen Axon-Ausdruck in einen AST. Nützlich zum Erstellen von Tools auf höherer Ebene über dem Server.

executeAxonCode

Werten Sie einen Axon-Ausdruck gegen das primäre SkySpark-Projekt aus. Gibt das Ergebnis als Haystack-Grid-JSON zurück.

commitAxonFunction

Commiten Sie eine Funktion in das primäre Projekt. Mit aktiviertem functionVersionioning wird die vorherige Version beibehalten.

SkySpark-Integration

Tools für die Kommunikation mit einer Live-SkySpark-Instanz.

queryHaystack

Führen Sie eine Haystack-Abfrage aus (read, readAll, history usw.) und geben Sie das Ergebnis-Grid zurück.

listSkySparkProjects / switchSkySparkProject

Aufzählung von Projekten auf der konfigurierten Instanz und Änderung des aktiven Projektkontexts für nachfolgende Aufrufe.

discoverProjectFunctions / discoverInstanceProjects

Durchsuchen Sie die konfigurierten Projekte der Instanz, synchronisieren Sie ihre benutzerdefinierten Funktionen in den lokalen Index und machen Sie sie suchbar.

getProjectSchema

Geben Sie das Haystack-Schema (Tags, Marker, definierte Typen) für ein Projekt zurück.

setPrimaryProject / getPrimaryProject

Verwalten Sie den primären Projektkontext, der von executeAxonCode und commitAxonFunction verwendet wird.

Graphenanalyse und Ähnlichkeit

Tools, die auf dem Code-Graph und dem Vektor-Embedding-Store aufgebaut sind.

getCallers / getCallees

Direkte Nachbarn im Aufrufgraph — wer ruft X auf und was X aufruft.

getCodeImpact

Ausbreitungsradius-Analyse. Geben Sie eine Funktion an und geben Sie jede nachgelagerte Funktion zurück, die von einer Änderung daran betroffen wäre.

findCodePath

Kürzester Aufrufrufpfad zwischen zwei Funktionen. Praktisch, um zu verfolgen, wie eine Blattfunktion vom Eingabepunkt erreicht wird.

semanticCodeSearch

Abfragen in natürlicher Sprache, die Code nach Bedeutung zurückgeben. "Find anything that resets daily energy counters at midnight" funktioniert auch, wenn kein Code diese Wörter wörtlich enthält.

findSimilarCode

Vektorähnlichkeit zwischen einem bereitgestellten Code-Snippet und der indexierten Codebasis. Nützlich zur Deduplizierung und Refactor-Erkennung.

getGraphMetrics / getMostCalledFunctions / getMostComplexFunctions

Zwischenzentralitäts-, Kopplungs- und Komplexitäts-Rankings.

buildProjectGraph / buildProjectEmbeddings / getGraphStats

Wartungstools zum Neuaufbau und zur Inspektion der Indizes.

detectCycles

Erkennungsfähigkeit zirkulärer Abhängigkeiten über den Aufrufgraph.

Fehlerbehandlungskonventionen

Alle Tools geben bei Fehlern ein strukturiertes Error zurück, anstatt zu werfen. Der Error-Body enthält einen code (z. B. INDEX_NOT_FOUND, SKYSPARK_UNREACHABLE, INVALID_ARGUMENT) und eine benutzerfreundliche message. Clients sollten den code Endbenutzern anzeigen und die message zum Debuggen protokollieren.