Installation

Prérequis

• Node.js 18 ou plus récent — nodejs.org.
• Git — pour cloner le référentiel.
• npm — fourni avec Node.js.

Une instance SkySpark active est facultative mais déverrouille les fonctionnalités d'exécution, de synchronisation et de requête en direct une fois que vous en connectez une.

Cloner et construire

git clone https://github.com/Project-SandStar/axon-mcp-server.git
cd axon-mcp-server

# Installer les dépendances
npm install

# Compiler TypeScript en JavaScript
npm run build

La construction émet vers dist/. Si vous voyez des erreurs TypeScript, confirmez que votre version de Node est 18+ avec node --version.

Initialisation de la base de données pour la première fois

Le tableau de bord administrateur et le magasin utilisateur persistent dans SQLite via Prisma. Exécutez la migration initiale une fois :

npx prisma migrate deploy

Cela crée .data/app.db et initialise un compte administrateur initial. Identifiants par défaut : admin / admin — changez le mot de passe immédiatement lors de la première connexion.

Démarrer le serveur

Mode stdio (pour les clients MCP locaux)

Valeur par défaut. Les clients IA comme Claude Desktop lancent le serveur en tant que sous-processus et communiquent via stdin/stdout.

npm start

Mode HTTP (pour les clients MCP distants + le tableau de bord administrateur)

MCP_TRANSPORT=http MCP_PORT=3847 npm start

• Point de terminaison MCP : http://localhost:3847/mcp
• Tableau de bord administrateur : http://localhost:3847/admin
• Points de terminaison OAuth : http://localhost:3847/oauth/*

Intégrez-le dans votre client MCP

Pour Claude Desktop, ajoutez un bloc à claude_desktop_config.json :

{
  "mcpServers": {
    "axon": {
      "command": "node",
      "args": ["/absolute/path/to/axon-mcp-server/dist/index.js"],
      "env": {
        "AXON_CONFIG": "/absolute/path/to/axon-config.json"
      }
    }
  }
}

Redémarrez le client. L'ensemble d'outils axon devrait apparaître dans le sélecteur d'outils.

Vérifiez que cela fonctionne

Avec le serveur en fonctionnement, le premier appel searchAxonExamples déclenche la passe d'indexation initiale du code et de la documentation. Attendez-vous à 30 à 60 secondes la première fois ; les redémarrages ultérieurs chargent l'index en cache en moins d'une seconde.

Si vous voyez des erreurs INDEX_NOT_FOUND, vérifiez que codePath et docsPath dans votre configuration pointent vers des répertoires qui contiennent réellement des fichiers .axon / .html.