MCP Fantom
Fantom-Dokumentation, semantische Codesuche und SkySpark-Migration
Bringen Sie Ihrem KI-Assistenten Fantom bei – und übergeben Sie ihm die Schlüssel zu Ihrer SkySpark 4.0 Migration.
MCP Fantom indexiert Fantom-Dokumentation von fantom.org, lokale .fan Pods und Haxall-Workflows in eine einzige durchsuchbare Oberfläche. Es führt semantische Codesuche über Tausende von Typen und Methoden durch, analysiert Call Graphs mit Community Detection und – einzigartig – automatisiert die SkySpark 3.x zu 4.0 Migration: Umschreiben von using-Anweisungen, Konvertieren von Axon-Strings, Generieren von Xeto-Dateien, Validierung mit dem Fantom-Compiler und Erstellen eines Git-Backup-Tags auf dem Weg.
Wenn die Migration fehlschlägt, können Sie mit einem Tool-Aufruf zurückrollen. Die gesamte Reise ist vergleichbar, rückgängig machbar und dokumentiert.
Warum es existiert
SkySpark 4.0 änderte das Erweiterungsformat. Die manuelle Migration einer echten Erweiterung oder eines Connectors ist eine mühsame Arbeit mit using-Umschreibungen, Axon-String-Konvertierungen und brandneuen Xeto-Bibliotheksdateien – mit einem Compiler, der zubeißt, sobald Sie eine Zeile verpassen. MCP Fantom verwandelt diese Arbeit in einen KI-gesteuerten Workflow, der die Regeln kennt, die Prüfungen durchführt und sich selbst rückgängig machen kann.
Für wen es gedacht ist
- Erweiterungsautoren, die SkySpark 3.x Pods zu 4.0 migrieren
- Haxall-Integratoren, die Connectors, Funktionen und Apps in Fantom erstellen
- 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 committed es. Ein drittes rollback es. Jede Änderung ist vergleichbar, der Compiler überprüft, Git hält das Sicherheitsnetz.
fan compile. Rollback available via rollbackMigration until commitMigration is called.
Lazy Indexing
Der Server antwortet, bevor die Indizierung abgeschlossen ist
Die meisten Suchserver blockieren den Client beim ersten Start für 30 bis 60 Sekunden während der Indizierung. MCP Fantom startet in unter einer Sekunde. Tools antworten sofort – FlexSearch wärmt sich zuerst auf, lokale Pods folgen, Embeddings danach. Der Assistent wartet nie.
Abfragen werden transparent degradiert. Falls Embeddings nicht bereit sind, fallen semantische Tools auf Stichwortsuche zurück. Der Assistent erhält eine Antwort mit einem Hinweis zur Treue, nicht zu einem Timeout.
Code Intelligence
Semantisches Verständnis, nicht nur Textübereinstimmung
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 Stichwörter.
Graphology mit Louvain-Clustering findet die natürlichen Gemeinschaften 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.
Migration Safety
Jede Migration ist nur eine Rückgängigmachung entfernt
migrateSkySpark4x erstellt ein Git-Tag, bevor es ein einzelnes Byte schreibt. Wenn etwas fehlschlägt – Compilerfehler, Validierungsnichtübereinstimmung, Ihr Bauchgefühl – rollbackMigration stellt das Repo in den genauen Zustand vor dem Lauf wieder her.
commitMigration ist absichtlich. Nichts wird in Ihre Arbeitshistorie gemergt, bis Sie die Ausgabe akzeptieren. Bis dahin lebt die Migration auf einem Branch mit einem Backup-Tag, bereit, verworfen zu werden.
using rewrites + Axon conversion + Xeto generation.migrateSkySpark4x was called.Guided Workflows
Beyond tools -- readable guides
MCP resources are markdown documents the assistant can read on demand. MCP Fantom ships four: a pod scaffolder, a fanr publishing guide, a Haxall extension walkthrough, and a fant unit-testing primer.
When a developer asks "how do I start?", the assistant pulls the right resource, summarizes, and proceeds. Every workflow is versioned alongside the server.
- ✓ Step-by-step markdown
- ✓ Discoverable via
resources/list - ✓ Versioned with the server
- ✓ Easy to add more
Tech-Stack
Architektur
Funktionen
- 20+ MCP-Tools – über Dokumentationssuche, semantische Codesuche, Call-Graph-Analyse, Code-Generierung und Migrationsautomatisierung
- Lazy Indexing – der Server startet in Sekunden und antwortet sofort; das Indexieren erfolgt im Hintergrund und Tools funktionieren mit Beeinträchtigungen, während es läuft
- Semantische Suche – LanceDB plus HuggingFace Transformers Embeddings für "ähnlichen Code finden" und Cross-Modal-Abfragen
- Call Graph + Community Detection – Graphology und Louvain zeigen natürliche Cluster in großen Fantom-Codebases
- SkySpark 4.x Migration – automatisiertes Umschreiben von
using-Anweisungen, Axon-Strings und Xeto-Dateigenerierung (lib.trio,funcs.xeto,lib.xeto), Compiler-Validierung, Git-Backup-Tag - Rollback – stellen Sie aus dem automatisch erstellten Git-Tag wieder her, falls die Migrationsausgabe Prüfungen nicht besteht
- 4 Workflow-Ressourcen –
create-pod,use-fanr,haxall-basics,unit-testing - Dualer Transport – stdio und HTTP mit OAuth
Tool-Oberfläche (Teilweise)
searchFantomDocs, getFantomType, listFantomPods, refreshIndex, searchFantomCode, getFantomFunction, generateFantomCode, validateFantomCode, migrateSkySpark4x, commitMigration, rollbackMigration, semanticCodeSearch, findSimilarCode, getCallers, getCallees, getCodeImpact, plus Projekt- und Instanzmanagement.
Anforderungen
- Node.js 18+
- Lokale Fantom und Haxall Toolchain für Migrationscompiler-Validierung
- Git Repository für Migrations-Backups
Interesse an diesem Projekt?
Erkunde den Quellcode, trage bei oder nimm Kontakt auf.