Kurulum

Ön Koşullar

• Node.js 20 veya daha yeni — nodejs.org.
• Git — depoyu klonlamak için.
• npm — Node.js ile birlikte gelir.

Etkin bir SkySpark örneği isteğe bağlıdır ancak bir tane bağladığınızda yürütme, senkronizasyon ve canlı sorgu özelliklerinin kilidini açar.

Klonlayın ve derleyin

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

# Bağımlılıkları yükleyin
npm install

# TypeScript'i JavaScript'e derleyin
npm run build

Derleme dist/ klasörüne çıktı verir. TypeScript hataları görürseniz, node --version komutuyla Node sürümünüzün 20+ olduğunu doğrulayın.

İlk kez veritabanı başlatma

Yönetici panosu ve kullanıcı deposu Prisma aracılığıyla SQLite'ye kaydedilir. İlk geçişi bir kez çalıştırın:

npx prisma migrate deploy

Bu, .data/app.db dosyasını oluşturur ve başlangıç yönetici hesabını ekler. Varsayılan kimlik bilgileri: admin / admin — ilk oturum açışta parolayı hemen değiştirin.

Sunucuyu başlatın

Stdio modu (yerel MCP istemcileri için)

Varsayılan. Claude Desktop gibi yapay zeka istemcileri sunucuyu bir alt işlem olarak başlatır ve stdin/stdout üzerinden iletişim kurar.

npm start

HTTP modu (uzak MCP istemcileri + yönetici panosu için)

MCP_TRANSPORT=http MCP_PORT=3847 npm start

• MCP uç noktası: http://localhost:3847/mcp
• Yönetici panosu: http://localhost:3847/admin
• OAuth uç noktaları: http://localhost:3847/oauth/*

Bunu MCP istemcinize bağlayın

Claude Desktop için claude_desktop_config.json dosyasına bir blok ekleyin:

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

İstemciyi yeniden başlatın. axon araç seti, araç seçicide görünmelidir.

Çalışıp çalışmadığını doğrulayın

Sunucu çalışırken, ilk searchAxonExamples çağrısı ilk kod + dokümantasyon indeksleme geçişini tetikler. İlk seferde 30–60 saniye bekleyin; sonraki yeniden başlatmalar, önbelleğe alınmış dizini bir saniyenin altında yükler.

INDEX_NOT_FOUND hataları görürseniz, yapılandırmanızdaki codePath ve docsPath değerlerinin gerçekten .axon / .html dosyaları içeren dizinleri gösterdiğini kontrol edin.