التثبيت

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

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

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

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

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

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

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

ينبعث البناء إلى dist/. إذا رأيت أخطاء TypeScript، تأكد من أن إصدار Node لديك يبلغ 20+ باستخدام 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.