Installation

Voraussetzungen

• Node.js 18 oder neuer — nodejs.org.
• Git — zum Klonen des Repositorys.
• npm — im Lieferumfang von Node.js enthalten.

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

Klonen und Bauen

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

# Abhängigkeiten installieren
npm install

# TypeScript zu JavaScript kompilieren
npm run build

Der Build wird zu dist/ ausgegeben. Falls Sie TypeScript-Fehler sehen, bestätigen Sie, dass Ihre Node-Version 18+ mit node --version ist.

Erstmalige Datenbankinitialisierung

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

npx prisma migrate deploy

Dies erstellt .data/app.db und initialisiert ein Admin-Konto. Standardanmeldedaten: admin / admin — ändern Sie das Passwort sofort beim ersten Anmelden.

Server starten

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

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

npm start

HTTP-Modus (für Remote-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-Tool-Satz sollte im Tool-Picker erscheinen.

Überprüfen Sie, ob es funktioniert

Bei laufendem Server löst der erste searchAxonExamples-Aufruf den ersten Code- und Dokumentationsindexierungsdurchlauf aus. Rechnen Sie das erste Mal mit 30–60 Sekunden; nachfolgende Neustarts laden den gecachten Index in unter einer Sekunde.

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