Installation

Mettez le serveur en service localement en moins de cinq minutes.

Prérequis

  • Node.js 20 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 compiler

git clone https://github.com/Project-SandStar/AxonMcpServer.git
cd AxonMcpServer

# Installer les dépendances
npm install

# Compiler TypeScript en JavaScript
npm run build

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

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

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

npx prisma migrate deploy

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

Démarrer le serveur

Mode Stdio (pour les clients MCP locaux)

La valeur par défaut. Les clients IA comme Claude Desktop lancent le serveur en tant que sous-processus et communiquent sur 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 à 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 cours d'exécution, le premier appel searchAxonExamples déclenche la passe initiale d'indexation du code et de la documentation. Attendez-vous à 30–60 secondes la première fois ; les redémarrages ultérieurs chargent l'index mis 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.