Aperçu

Ce que c'est

Le serveur Axon MCP est un serveur Model Context Protocol qui donne aux assistants IA un accès au niveau expert à une base de code Axon. Il indexe les fichiers source Axon et la documentation HTML, expose les outils de recherche et de génération de code via MCP, et peut exécuter des requêtes contre une instance SkySpark en direct.

Axon est le langage spécialisé de SkySpark pour l'automatisation des bâtiments, le contrôle des systèmes de chauffage, de ventilation et de climatisation, et la gestion de l'énergie. Le serveur MCP transforme un dossier de code Axon en une base de connaissances structurée que tout client compatible MCP — Claude Desktop, Cursor, l'interface de ligne de commande MCP — peut interroger.

Ce que vous pouvez faire avec lui

• Rechercher dans le code et la documentation Axon — recherche textuelle complète alimentée par FlexSearch avec notation de pertinence, requêtes au niveau des opérateurs et motifs d'expression régulière.
• Générer du nouveau code Axon — 33 modèles YAML spécialisés pour les flux de travail courants en matière de chauffage, ventilation, climatisation, énergie, défauts et données. Le code généré est validé sémantiquement avant d'être renvoyé.
• Exécuter du code sur une instance SkySpark en direct — exécuter des requêtes Haystack, évaluer des expressions Axon et valider des fonctions avec versioning automatique.
• Analyser les graphes d'appels — trouver les appelants et les appelés, détecter les dépendances circulaires, identifier les fonctions les plus appelées ou les plus complexes.
• Recherche sémantique avec plongements vectoriels — requêtes en langage naturel qui retournent du code par sens, pas seulement par correspondance de mot-clé.

Comment cela s'articule

┌──────────────────┐     MCP       ┌──────────────────────┐      HTTP    ┌────────────┐
│ Client IA        │ ─────────────▶│ Serveur Axon MCP     │ ────────────▶│ SkySpark   │
│ (Claude, Cursor) │               │  • index de recherche│              │ (Haystack) │
│                  │               │  • générateur de code│              └────────────┘
│                  │ ◀─────────────│  • analyseur de graph│
└──────────────────┘    résultats   │  • OAuth 2.1         │
                                    └──────────────────────┘
                                              │
                                              ▼
                                       fichiers .axon / .trio
                                       documentation HTML

Les connexions s'exécutent sur stdio (pour les clients IA locaux qui lancent le serveur en tant que sous-processus) ou http (pour les clients distants derrière OAuth). Le tableau de bord à /admin fournit une interface web pour la gestion des sessions et des utilisateurs.

Caractéristiques principales

• Recherche rapide — ~50 ms pour une recherche textuelle complète sur des milliers de fichiers HTML ; l'indexation initiale prend 30–60 s et est mise en cache.
• OAuth 2.1 avec PKCE — authentification multi-utilisateurs, jetons étendus (mcp:read, mcp:write, mcp:admin).
• Versioning des fonctions — conserve automatiquement les 4 dernières révisions de chaque fonction validée via le serveur.
• Découverte automatique — configurez une instance SkySpark ; le serveur énumère les projets et synchronise automatiquement leurs fonctions.
• Persistance SQLite locale — le magasin d'utilisateurs, les manifestes de sauvegarde et les métriques de graphe se trouvent tous dans un seul fichier via Prisma.

État du projet

Le serveur est en développement actif et est considéré comme stable pour les flux de travail de recherche, d'exécution et de génération de code. Licence : ISC. Les problèmes et les contributions sont les bienvenus sur GitHub.