MCP Fantom
Documentation Fantom, Recherche sémantique de code et Migration SkySpark
Enseignez à votre assistant IA Fantom -- et confiez-lui les clés de votre migration SkySpark 4.0.
MCP Fantom indexe la documentation Fantom de fantom.org, vos pods .fan locaux et les workflows Haxall dans une seule surface consultable. Il exécute une recherche de code sémantique sur des milliers de types et de méthodes, analyse les graphes d'appels avec détection communautaire, et -- de façon unique -- automatise la migration SkySpark 3.x vers 4.0 : réécrit les déclarations using, convertit les chaînes Axon, génère des fichiers Xeto, valide avec le compilateur Fantom, et crée une balise Git de sauvegarde en chemin.
Si la migration échoue, restaurez-la avec un seul appel d'outil. Le parcours entier est comparable, réversible et commenté.
Pourquoi cela existe
SkySpark 4.0 a changé le format d'extension. La migration manuelle d'une véritable extension ou connecteur est fastidieuse : réécriture des using, conversions des chaînes Axon et de tout nouveaux fichiers de bibliothèque Xeto -- avec un compilateur qui mord le moment où vous manquez une ligne. MCP Fantom transforme ce travail en un workflow piloté par un assistant qui connaît les règles, exécute les vérifications et peut se défaire.
Pour qui c'est
- Auteurs d'extensions migrant les pods SkySpark 3.x vers 4.0
- Intégrateurs Haxall construisant des connecteurs, fonctions et applications en Fantom
- Développeurs assistés par l'IA qui ont besoin d'un contexte Fantom précis, pas de syntaxe hallucinez
Cockpit de Migration
Migrez SkySpark 3 vers 4 sans crampes aux mains
Un outil réécrit votre extension. Un autre la valide. Un troisième la restaure. Chaque changement est comparable, le compilateur vérifie, Git maintient le filet de sécurité.
fan compile. Restauration disponible via rollbackMigration jusqu'à ce que commitMigration soit appelé.
Indexation paresseuse
Le serveur répond avant la fin de l'indexation
La plupart des serveurs de recherche bloquent le client pendant 30 à 60 secondes au premier démarrage pendant qu'ils indexent. MCP Fantom démarre en moins d'une seconde. Les outils répondent immédiatement -- FlexSearch se réchauffe en premier, les pods locaux ensuite, les plongements après. L'assistant n'attend jamais.
Les requêtes se dégradent de manière transparente. Si les intégrations ne sont pas prêtes, les outils sémantiques reviennent à la recherche par mot-clé. L'assistant obtient une réponse avec une note sur la fidélité, pas un délai d'attente.
Intelligence du code
Compréhension sémantique, pas juste correspondance de texte
semanticCodeSearch et findSimilarCode intègrent votre code Fantom dans un espace vectoriel. Demandez « fonctions qui normalisent les unités » et obtenez des résultats qui partagent la structure, pas les mots-clés.
Graphologie avec clustering Louvain trouve les communautés naturelles dans votre codebase -- quels types s'accrochent ensemble, lesquels ne le font pas. getCodeImpact trace comment un changement se propage. getCallers et getCallees complètent la surface du graphe d'appels.
Sécurité de la migration
Chaque migration est à une annulation près
migrateSkySpark4x crée une balise Git avant d'écrire un seul octet. Si quelque chose échoue -- erreur du compilateur, discordance de validation, votre intuition -- rollbackMigration restaure le référentiel à l'état exact avant l'exécution.
commitMigration est délibéré. Rien n'est fusionné dans votre historique de travail jusqu'à ce que vous acceptiez la sortie. Jusque-là, la migration vit sur une branche, avec une balise de sauvegarde, prête à être rejetée.
using réécritures + conversion Axon + génération Xeto.migrateSkySpark4x.Flux de travail guidés
Au-delà des outils -- guides lisibles
Les ressources MCP sont des documents markdown que l'assistant peut lire à la demande. MCP Fantom en expédie quatre : un générateur de pod, un guide de publication fanr, une procédure pas à pas d'extension Haxall et une introduction aux tests unitaires fant.
Quand un développeur demande « comment commencer ? », l'assistant récupère la bonne ressource, fait un résumé et continue. Chaque flux de travail est versionné avec le serveur.
- ✓ Markdown étape par étape
- ✓ Découvrable via
resources/list - ✓ Versionné avec le serveur
- ✓ Facile à en ajouter d'autres
Pile technologique
Architecture
Capacités
- 20+ outils MCP -- couvrant la recherche de documentation, la recherche sémantique de code, l'analyse de graphe d'appels, la génération de code et l'automatisation de la migration
- Indexation paresseuse -- le serveur démarre en quelques secondes et répond immédiatement ; l'indexation se fait en arrière-plan et les outils se dégradent gracieusement pendant qu'il s'exécute
- Recherche sémantique -- LanceDB plus les intégrations HuggingFace Transformers pour « trouver du code similaire » et des requêtes multi-modales
- Graphe d'appels + détection communautaire -- Graphologie et Louvain mettent en avant les clusters naturels dans les grandes bases de code Fantom
- Migration SkySpark 4.x -- réécriture automatisée des déclarations
using, chaînes Axon et génération de fichiers Xeto (lib.trio,funcs.xeto,lib.xeto), validation du compilateur, balise de sauvegarde Git - Restauration -- restaurer à partir de la balise Git créée automatiquement si la sortie de migration échoue les vérifications
- 4 ressources de workflow --
create-pod,use-fanr,haxall-basics,unit-testing - Transport double -- stdio et HTTP avec OAuth
Surface d'outils (Partielle)
searchFantomDocs, getFantomType, listFantomPods, refreshIndex, searchFantomCode, getFantomFunction, generateFantomCode, validateFantomCode, migrateSkySpark4x, commitMigration, rollbackMigration, semanticCodeSearch, findSimilarCode, getCallers, getCallees, getCodeImpact, plus gestion de projets et d'instances.
Exigences
- Node.js 18+
- Toolchain Fantom et Haxall local pour la validation du compilateur de migration
- Référentiel Git pour les sauvegardes de migration
Intéressé par ce projet ?
Explorez le code source, contribuez ou prenez contact.