MCP Fantom
Semantische Codesuche für Fantom und Axon -- Lokale GPU oder OpenRouter
Lehren Sie Ihren KI-Assistenten Fantom und Axon -- mit oder ohne Ihre eigene GPU.
MCP Fantom vermittelt einem KI-Assistenten praktisches Wissen über eine Fantom-, Haxall- und SkySpark-Codebasis -- nicht nur ihre Dokumentation, sondern den tatsächlichen Code: was ruft was auf, was hat sich letzte Woche geändert, und welche Funktion macht das, das Sie auf Deutsch beschreiben.
Es indexiert Fantom-Quellcode, SkySpark-Axon-Funktionen und die Dokumentationen von fantom.org und haxall.io; betten alles für semantische Suche ein; erstellt einen echten Call-Graphen; und stellt alles über das Model Context Protocol zur Verfügung, zusammen mit einem Web-Dashboard zum Ausführen und Überwachen der Indizierung.
Neu in 1.0: OpenRouter
Embedding benötigt keine GPU auf Ihrem Schreibtisch mehr. Jede Inferenzrolle -- Code-Embedding, Text-Embedding, Reranking, der Code-Assistent und die Abrufschleife -- wird unabhängig zu lokalen Hosts, zu OpenRouter oder zu beiden gleichzeitig geroutet. Führen Sie alles von einem Laptop aus in der Cloud aus, vollständig auf Ihrer eigenen Hardware in einem isolierten Betrieb oder verteilen Sie über beide Pools, die aus einer Warteschlange ziehen.
Es migriert weiterhin SkySpark
SkySpark 4.0 hat das Erweiterungsformat geändert. Manuelles Migrieren einer realen Erweiterung oder eines Konnektors ist zeitaufwändig: using-Umschreibungen, Axon-String-Konvertierungen und brandneue Xeto-Bibliotheksdateien -- mit einem Compiler, der augenblicklich reagiert, wenn Sie eine Zeile vermissen. MCP Fantom schreibt die using-Anweisungen um, konvertiert die Axon-Strings, generiert die Xeto-Dateien, validiert mit dem Fantom-Compiler und erstellt auf dem Weg zur Sicherung ein Git-Backup-Tag.
Wenn die Migration bricht, rollback mit einem Tool-Aufruf. Die ganze Reise ist vergleichbar, rückgängig zu machen und erzählt.
Für wen ist das
- Extension-Autoren, die SkySpark-3.x-Pods zu 4.0 migrieren
- Haxall-Integratoren, die Konnektoren, Funktionen und Apps in Fantom erstellen
- SkySpark-Entwickler, die ihre Axon-Funktionen nach Bedeutung durchsuchbar machen möchten, nicht nach grep
- KI-unterstützte Entwickler, die genauen Fantom-Kontext benötigen, nicht halluzinierte Syntax
Migration Cockpit
Migrieren Sie SkySpark 3 zu 4 ohne Handkrämpfe
Ein Tool schreibt Ihre Erweiterung um. Ein anderes schreibt sie zu. Ein drittes rollback. Jede Änderung ist vergleichbar, der Compiler verifiziert, Git hält das Sicherheitsnetz.
fan compile. Rollback verfügbar via rollbackMigration bis commitMigration aufgerufen wird.
Lazy Indexing
Der Server antwortet, bevor der Index fertig ist
Die meisten Suchserver blockieren den Client beim ersten Start 30 bis 60 Sekunden lang während der Indizierung. MCP Fantom bootet in unter einer Sekunde. Tools reagieren sofort -- FlexSearch wärmt sich zuerst auf, lokale Pods danach, Einbettungen später. Der Assistent wartet nie.
Abfragen verschlechtern sich transparent. Wenn Einbettungen nicht bereit sind, fallen semantische Tools zu Keyword-Suche zurück. Der Assistent erhält eine Antwort mit einer Anmerkung zur Treue, nicht Timeout.
Code-Intelligenz
Semantisches Verständnis, nicht nur Textmatch
semanticCodeSearch und findSimilarCode betten Ihren Fantom-Code in einen Vektorraum ein. Fragen Sie nach "Funktionen, die Einheiten normalisieren" und erhalten Sie Ergebnisse, die Struktur teilen, nicht Keywords.
Graphology mit Louvain-Clustering findet die natürlichen Communities in Ihrer Codebasis -- welche Typen hängen zusammen, welche nicht. getCodeImpact verfolgt, wie sich eine Änderung ausbreitet. getCallers und getCallees runden die Call-Graph-Oberfläche ab.
Migrationssicherheit
Jede Migration ist einen Rückgängigmachen entfernt
migrateSkySpark4x erstellt ein Git-Tag, bevor es ein einziges Byte schreibt. Wenn etwas fehlschlägt -- Compiler-Fehler, Validierungskonflikt, Ihr Bauchgefühl -- rollbackMigration stellt das Repo exakt in dem Zustand vor der Ausführung wieder her.
commitMigration ist bewusst. Nichts wird in Ihre Arbeitsverlauf gemergt, bis Sie die Ausgabe akzeptieren. Bis dahin befindet sich die Migration auf einem Branch mit einem Sicherungs-Tag, bereit zum Verwerfen.
using Umschreibungen + Axon-Konvertierung + Xeto-Generierung.migrateSkySpark4x aufgerufen wurde.skyspark-4x-migration, connector-workflow und xeto-spec-guide.Geführte Workflows
Über Tools hinaus -- lesbare Guides
MCP-Ressourcen sind Markdown-Dokumente, die der Assistent bei Bedarf lesen kann. MCP Fantom wird mit dreizehn geliefert: Ein Pod-Gerüst, ein fanr-Veröffentlichungsleitfaden, eine Haxall-Erweiterungsanleitung, ein fant Unit-Testing-Primer, ein SkySpark-4.x-Migrationsplaybook, ein Xeto-Spec-Leitfaden und mehr.
Wenn ein Entwickler fragt "wie fange ich an?", zieht der Assistent die richtige Ressource, fasst zusammen und geht weiter. Jeder Workflow ist zusammen mit dem Server versioniert.
- ✓ Schritt-für-Schritt Markdown
- ✓ Auffindbar via
resources/list - ✓ Mit dem Server versioniert
- ✓ Einfach, um mehr hinzuzufügen
Provider-Routing
Ihre GPU, OpenRouter oder beide gleichzeitig
Jede Inferenzrolle wird eigenständig geroutet. Embedding kann über lokale GPUs und OpenRouter fächerförmig ausgebreitet werden und zieht aus einer Warteschlange, während Reranking nur cloudbasiert läuft und die Abrufschleife vor Ort bleibt. Vier Richtlinien, fünf Rollen, pro Rolle gesetzt und zur Laufzeit geändert.
Eine Rolle, die auf OpenRouter verweist, wird zu einem virtuellen Container: echte Serving-Kapazität ohne GPU und kein VRAM dahinter, registriert als eigener logischer Provider, damit der Scheduler ihm Arbeit wie jedem anderen Host zuweisen kann. Kein lokales Modell bedeutet keine lokale Hardware-Anforderung -- MCP Fantom indexiert eine Codebasis von einem Laptop.
- ✓
aggregate-- lokal und Cloud in einem Fan-Out-Pool - ✓
backup-- lokal zuerst, Cloud als Reserve - ✓
local-- abgeschottet, nichts verlässt das Netzwerk - ✓
cloud-- nur OpenRouter, keine GPU erforderlich
0.99 Kosinus entsprechen, in genau der konfigurierten Dimension, bevor er eine einzelne Zeile schreiben darf.
Tech-Stack
Architektur
Funktionen
- 41 MCP-Tools -- über Dokumentationssuche, semantische Codesuche, Call-Graph-Analyse, Code-Verlauf, Code-Generierung und Migrationsautomation
- Provider-Routing pro Rolle --
code-embedding,embedding,reranker,code-assistantundrlmnehmen jeweils ihre eigene Richtlinie:local,cloud(nur OpenRouter),aggregate(beide in einem Fan-Out-Pool) oderbackup(lokal zuerst, Cloud als Reserve) - Lazy Indexing -- der Server bootet in Sekunden und antwortet sofort; Indizierung läuft im Hintergrund und Tools verschlechtern sich elegant während dieser Zeit
- Semantische Suche -- LanceDB hinter einem ANN-Index, mit optionalem Cross-Encoder oder OpenRouter-Reranker
- Natural-Language Q&A --
askCodebaseführt eine Abrufschleife über den Index aus und synthetisiert eine zitierte Antwort - Ein echter Call Graph --
getCallers,getCallees,getCodeImpactundgetCodeNeighborsbeantworten strukturelle Fragen aus einer eingebetteten Graphdatenbank, nicht durch Grep - Axon-Unterstützung -- SkySpark-Axon-Funktionen aus synchronisierten
proj/-Ordnern oder Offline-Bibliotheksexporten, geparst mit einer speziell entwickelten Tree-Sitter-Grammatik, damit Chunks auf Anweisungsgrenzen landen unddefcomp-Zellen als Komponentenschnittstelle auftauchen - Verlauf --
whatChangedRecently,getSymbolHistory,explainSymbolChangeunddiffIndexRunszeigen, wie der Code so geworden ist - SkySpark-4.x-Migration -- automatisches Umschreiben von
using-Anweisungen und Axon-Strings, Xeto-Dateigenerierung (lib.trio,funcs.xeto,lib.xeto), Compiler-Validierung, Git-Sicherungs-Tag, One-Call-Rollback - 13 Workflow-Ressourcen -- lesbare Markdown-Guides von
create-podbisskyspark-4x-migration - Doppelter Transport -- stdio und HTTP mit einem Next.js-Dashboard für Index-Abdeckung, Einbettungsfortschritt und Provider-Routing
Cloud ohne die Stolperfallen
Einen Cloud-Embedder in einen Index fallen zu lassen, den eine lokale GPU erstellt hat, führt dazu, dass der Abruf leise verfault -- die kosinale Distanz wird nicht mehr vergleichbar und nichts sagt es Ihnen. MCP Fantom behandelt dies als eine harte Vorbedingung und nicht als Warnung:
- Vektor-Kompatibilitätsgate -- ein Cloud-Provider bettet Sondierungstexte neben einem Referenz-Provider ein und muss einen Mindest-Kosinus von 0,99, in genau der konfigurierten Dimension, bestätigen, bevor er eine einzelne Zeile schreiben darf. Der Abfrage-Encoder kommt immer aus dem Pool, der diese Zeilen erstellt hat.
- Angeheftete Upstream-Server -- zwei OpenRouter-Hosts, die dasselbe Modell-Slug bedienen, garantieren keine identischen Vektoren, daher muss jede Einbettungsroute seinen Upstream benennen. Reranking ist zustandslos und benötigt keine Stecknadel.
- Ein gemeinsames Budget -- OpenRouter stellt Rate-Limits pro Schlüssel fest, nicht pro Aufrufer, daher wird die gesamte Cloud-Parallelität aus einem einzelnen globalen Permit-Pool gezogen, der aus gemessener Latenz nach Little's Law dimensioniert ist. Ein 429 halbiert das Budget und zieht sich mit Jitter zurück; die lokalen GPUs arbeiten direkt durch.
- Nur-Schreib-Schlüssel -- der API-Schlüssel wird an den Sidecar weitergeleitet, der ihn verwendet. Er wird nie in die Konfiguration geschrieben, nie protokolliert und von keinem Endpunkt zurückgegeben.
Tool-Oberfläche (Teilweise)
searchFantomCode, semanticCodeSearch, askCodebase, findSimilarCode, getFantomType, getFantomFunction, searchLocalDocs, searchVersionedApi, listFantomPods, getCallers, getCallees, getCodeImpact, getCodeNeighbors, whatChangedRecently, getSymbolHistory, explainSymbolChange, diffIndexRuns, axonSearch, axonFunction, generateFantomCode, migrateSkySpark4x, commitMigration, rollbackMigration, plus Projekt- und Instanzenverwaltung.
Anforderungen
- Node.js 20+
- Ein Embedding-Provider -- ein lokales Modell oder ein OpenRouter-Schlüssel
- Lokale Fantom- und Haxall-Toolchain für Migrations-Compiler-Validierung
- Git-Repository für Migrations-Sicherungen
Interesse an diesem Projekt?
Erkunde den Quellcode, trage bei oder nimm Kontakt auf.