Kurulum

Ön Koşullar

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

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

Klonlayın ve oluşturun

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

# 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 ile Node sürümünüzün 18+ olduğunu doğrulayın.

İlk kez veritabanı başlatılması

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

npx prisma migrate deploy

Bu .data/app.db oluşturur ve bir ilk yönetici hesabı başlatır. Varsayılan kimlik bilgileri: admin / admin — ilk girişte parolayı hemen değiştirin.

Sunucuyu başlatın

Stdio modu (yerel MCP istemcileri için)

Varsayılan. Claude Desktop gibi AI 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 paneli için)

MCP_TRANSPORT=http MCP_PORT=3847 npm start

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

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ıştığını doğrulayın

Sunucu çalışırken, ilk searchAxonExamples çağrısı ilk kod + dokümantasyon dizinleme geçişini tetikler. İlk seferde 30–60 saniye bekleyin; sonraki yeniden başlatmalar önbelleğe alınan dizini bir saniyeden kısa sürede yükler.

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