التثبيت

المتطلبات الأساسية

• Node.js 18 أو أحدث — nodejs.org.
• Git — لاستنساخ المستودع.
• npm — مضمن مع Node.js.

مثيل SkySpark نشط اختياري ولكنه يفتح ميزات التنفيذ والمزامنة والاستعلام المباشر بمجرد توصيل واحد.

الاستنساخ والبناء

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

# تثبيت المتعلقات
npm install

# تجميع TypeScript إلى JavaScript
npm run build

ينبعث البناء إلى dist/. إذا كنت ترى أخطاء TypeScript، فتأكد من أن إصدار Node لديك هو 18 أو أحدث باستخدام node --version.

تهيئة قاعدة البيانات للمرة الأولى

لوحة المسؤول ومتجر المستخدم يستمران في SQLite عبر Prisma. قم بتشغيل الترحيل الأولي مرة واحدة:

npx prisma migrate deploy

هذا ينشئ .data/app.db ويرسم حسابًا إداريًا أوليًا. بيانات الاعتماد الافتراضية: admin / admin — غيّر كلمة المرور فورًا عند تسجيل الدخول للمرة الأولى.

بدء الخادم

وضع Stdio (لعملاء MCP المحليين)

الافتراضي. العملاء الذكيون مثل Claude Desktop ينشئون الخادم كعملية فرعية ويتواصلون عبر stdin/stdout.

npm start

وضع HTTP (لعملاء MCP البعيدين + لوحة المسؤول)

MCP_TRANSPORT=http MCP_PORT=3847 npm start

• نقطة نهاية MCP: http://localhost:3847/mcp
• لوحة المسؤول: http://localhost:3847/admin
• نقاط نهاية OAuth: http://localhost:3847/oauth/*

وصله بعميل MCP الخاص بك

للـ Claude Desktop، أضف كتلة إلى 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"
      }
    }
  }
}

أعد تشغيل العميل. يجب أن تظهر مجموعة أدوات axon في منتقي الأدوات.

تحقق من أنه يعمل

مع تشغيل الخادم، يؤدي استدعاء searchAxonExamples الأول إلى تشغيل عملية الفهرسة الأولية للكود والمستندات. توقع 30-60 ثانية في المرة الأولى؛ تحميل إعادة التشغيل اللاحقة الفهرس المخزن مؤقتًا في أقل من ثانية.

إذا رأيت أخطاء INDEX_NOT_FOUND، فتحقق من أن codePath و docsPath في التكوين الخاص بك تشير إلى الدلائل التي تحتوي فعلاً على ملفات .axon / .html.