Installation

Voraussetzungen

• Node.js 20 oder neuer — nodejs.org.
• Git — zum Klonen des Repositorys.
• npm — mit Node.js gebündelt.

Eine aktive SkySpark-Instanz ist optional, schaltet aber die Ausführungs-, Synchronisierungs- und Live-Query-Funktionen frei, sobald Sie eine verbinden.

Klonen und Erstellen

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

# Abhängigkeiten installieren
npm install

# TypeScript in JavaScript kompilieren
npm run build

Der Build gibt an dist/ aus. Wenn Sie TypeScript-Fehler sehen, bestätigen Sie, dass Ihre Node-Version 20+ mit node --version ist.

Erste Datenbankinitialisierung

Das Admin-Dashboard und der Benutzerspeicher werden über Prisma in SQLite persistiert. Führen Sie die erste Migration einmalig aus:

npx prisma migrate deploy

Dies erstellt .data/app.db und iniciialisiert ein initiales Admin-Konto. Standardanmeldedaten: admin / admin — ändern Sie das Passwort sofort bei der ersten Anmeldung.

Server starten

Stdio-Modus (für lokale MCP-Clients)

Der Standard. KI-Clients wie Claude Desktop spawnen den Server als Unterprozess und kommunizieren über stdin/stdout.

npm start

HTTP-Modus (für entfernte MCP-Clients + Admin-Dashboard)

MCP_TRANSPORT=http MCP_PORT=3847 npm start

• MCP-Endpunkt: http://localhost:3847/mcp
• Admin-Dashboard: http://localhost:3847/admin
• OAuth-Endpunkte: http://localhost:3847/oauth/*

In Ihren MCP-Client integrieren

Für Claude Desktop fügen Sie einen Block zu claude_desktop_config.json hinzu:

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

Starten Sie den Client neu. Der axon-Toolsatz sollte in der Tool-Auswahl erscheinen.

Verifizieren Sie, dass es funktioniert

Wenn der Server läuft, löst der erste searchAxonExamples-Aufruf den initalen Code- und Dokumentationsindexierungsdurchgang aus. Erwarten Sie 30–60 Sekunden beim ersten Mal; nachfolgende Neustarts laden den zwischengespeicherten Index in unter einer Sekunde.

Wenn Sie INDEX_NOT_FOUND-Fehler sehen, überprüfen Sie, dass codePath und docsPath in Ihrer Konfiguration auf Verzeichnisse zeigen, die tatsächlich .axon- / .html-Dateien enthalten.