نظرة عامة

ما هو

خادم Axon MCP هو خادم Model Context Protocol يمنح مساعدي الذكاء الاصطناعي إمكانية وصول على مستوى الخبراء إلى قاعدة أكواد Axon. يقوم بفهرسة ملفات مصدر Axon والتوثيق بصيغة HTML، ويعرّض أدوات البحث وتوليد الأكواد عبر MCP، ويمكنه تنفيذ استعلامات ضد نسخة SkySpark مباشرة.

Axon هي لغة مجال متخصصة في SkySpark لبناء أنظمة التحكم، والتحكم في أنظمة التهوية والتدفئة والتبريد، وإدارة الطاقة. يحول خادم MCP مجلد أكواد Axon إلى قاعدة معرفة منظمة يمكن لأي عميل متوافق مع MCP — Claude Desktop أو Cursor أو MCP CLI — الاستعلام عنها.

ما يمكنك فعله به

• البحث عبر أكواد وتوثيق Axon — بحث نصي كامل مدعوم بـ FlexSearch مع تقييم الملاءمة والاستعلامات على مستوى المشغل والأنماط النمطية.
• توليد أكواد Axon جديدة — 33 قالب YAML منسقة لسير العمل الشائع في أنظمة التهوية والتدفئة والتبريد والطاقة والأعطال والبيانات. يتم التحقق من صحة الكود المولد دلاليًا قبل إرجاعه.
• تنفيذ الكود ضد نسخة SkySpark مباشرة — تشغيل استعلامات Haystack وتقييم تعبيرات Axon وإيداع الدوال مع إعادة إصدار تلقائية.
• تحليل مخططات الاستدعاءات — البحث عن المُستدعين والمستدعى لهم واكتشاف التبعيات الدائرية وتحديد الدوال الأكثر استدعاءً أو الأكثر تعقيدًا.
• البحث الدلالي مع عمليات التضمين المتجهة — استعلامات باللغة الطبيعية تُرجع أكوادًا بناءً على المعنى وليس فقط التطابق مع الكلمات الأساسية.

كيف يتناسب معًا

┌──────────────────┐     MCP       ┌──────────────────────┐      HTTP    ┌────────────┐
│ عميل ذكاء الآلة   │ ─────────────▶│ خادم Axon MCP        │ ────────────▶│ SkySpark   │
│ (Claude, Cursor) │               │  • فهرس البحث        │              │ (Haystack) │
│                  │               │  • مولد الأكواد       │              └────────────┘
│                  │ ◀─────────────│  • محلل الرسم البياني│
└──────────────────┘    النتائج    │  • OAuth 2.1         │
                                    └──────────────────────┘
                                              │
                                              ▼
                                       ملفات .axon / .trio
                                       توثيق HTML

تعمل الاتصالات عبر stdio (لعملاء الذكاء الاصطناعي المحليين الذين يولدون الخادم كعملية فرعية) أو http (للعملاء البعيدين خلف OAuth). توفر لوحة التحكم في /admin واجهة ويب لإدارة الجلسات والمستخدمين.

الميزات الرئيسية

• بحث سريع — بحث نصي كامل في ~50 مللي ثانية عبر آلاف ملفات HTML؛ يستغرق الفهرسة الأولية 30–60 ثانية ويتم تخزينها مؤقتًا.
• OAuth 2.1 مع PKCE — مصادقة متعددة المستخدمين وعلامات محدودة النطاق (mcp:read, mcp:write, mcp:admin).
• إعادة إصدار الدوال — يحتفظ تلقائيًا بآخر 4 نسخ من كل دالة تم إيداعها عبر الخادم.
• الاكتشاف التلقائي — قم بتكوين نسخة SkySpark واحدة؛ يقوم الخادم بعد ذلك بتعداد المشاريع ومزامنة دوالها تلقائيًا.
• استمرارية SQLite المحلية — متجر المستخدمين وقوائم النسخ الاحتياطية ومقاييس الرسم البياني تعيش جميعها في ملف واحد عبر Prisma.

حالة المشروع

الخادم قيد التطوير النشط ويُعتبر مستقرًا لسير العمل في البحث والتنفيذ وتوليد الأكواد. الترخيص: ISC. المشاكل والمساهمات مرحب بها على GitHub.