خادم Axon MCP

مكتبة معرفة Axon قابلة للاستعلام من قبل الذكاء الاصطناعي

v1.0.0 Published عرض المصدر Documentation

امنح مساعدي الذكاء الاصطناعي إمكانية وصول على مستوى الخبراء إلى قاعدة أكواد Axon لديك.

يقوم خادم Axon MCP بفهرسة آلاف دوال Axon، واستخدامات المشغلين، وصفحات توثيق SkySpark في مكتبة قابلة للبحث، ثم يكشفها من خلال بروتوكول السياق النموذجي. أي مساعد متوافق مع MCP -- Claude Desktop أو Cursor أو أدوات مخصصة -- يمكنه الاستعلام عن معرفة Axon لديك بالطريقة التي يفعلها مهندس أول: البحث عن المشغل، واستخراج أمثلة الاستخدام، وتتبع رسوم البيانات للاستدعاءات، وإنشاء أكواد مكتوبة، والتحقق قبل التنفيذ.

فهرسة أكثر من 4000 مستند HTML في 30 إلى 60 ثانية. الاستعلام عنها في أقل من 50 ميلي ثانية. احفظ الذاكرة المؤقتة لمدة 24 ساعة بحيث تكون عمليات الإقلاع اللاحقة فورية.

لماذا يوجد

Axon هي لغة مخصصة للمجال -- صغيرة وغريبة وجميلة -- ولم يرها معظم نماذج اللغات الكبيرة من قبل. بدون السياق، يرفض المساعد تقديم المساعدة أو يهلوس بثقة دالة غير موجودة. يغلق خادم Axon MCP هذه الفجوة بطبقة معرفة مؤسسة: كل اقتراح يأتي من كود مفهرس حقيقي، وكل دالة يتم إنشاؤها تم التحقق منها مسبقاً، وكل رسم بياني استدعاء ثنائي الاتجاه.

من يستخدمه

  • مطورو SkySpark الذين يكتبون منطق HVAC والطاقة والشرارات ويريدون برنامج شريك ذكاء اصطناعي حقيقي
  • مدمجو الأتمتة الذكية الذين يدمجون المعرفة عبر عشرات مشاريع Axon
  • الاستشاريون الذين يتابعون قاعدة أكواد Axon للعميل الجديد ويحتاجون إلى التنقل السريع

البحث في المكتبة

كل مثال Axon، استعلام واحد

4187 مستند. بحث أقل من 50ms. الفئات المفهرسة والمشغلين والأنماط، كل ذلك قابل للاستعلام من خلال واجهة MCP واحدة.

بحث Axon MCP
localhost:3000/search
البحث عن أمثلة axon... درجة حرارة المنطقة rollup
category:hvac kit:control since:30d بحث
الفئات
HVAC 412
الطاقة 287
العداد 198
التقارير 156
إدارة 104
تحليل الشرارات 89
حساس 76
تحكم 64
تحليل البيانات 58
الخدمات 44
occSchedule hvac
0.94

إرجاع جدول الإشغال للمنطقة بناءً على وضع أيام الأسبوع والنقطة المرجعية. شائع الاستخدام كبوابة في خطوط الأنابيب وقت التشغيل والتجميع.

جدول إشغال منطقة
hvacRuntime hvac
0.88

حساب وقت التشغيل كل ساعة لقطعة من المعدات عبر نطاق التاريخ. يحترم بوابات الإشغال ونقاط التجاوز اليدوية.

وقت التشغيل معدات تجميع
zoneTempRollup hvac
0.82

تجميع سجل درجة حرارة المنطقة إلى متوسطات يومية، مكتوبة بـ °F أو °C بناءً على اتفاقيات علامات الموقع.

hisRead تجميع يومي
energyBaseline طاقة
0.76

حساب خط الأساس للطاقة المعياري للطقس للموقع من بيانات العداد التاريخية ومدخلات درجة اليوم.

عداد خط الأساس طقس
setpointWrite تحكم
0.71

كتابة نقطة مرجعية جديدة لسجل النقطة مع معالجة الأولويات وعلامات سجل المراجعة.

نقطة كتابة نقطة مرجعية
إظهار 5 من 1488 مطابقات -- مفهرسة قبل 30 ثانية FlexSearch · 47ms

سطح أداة MCP

واجهة مدمجة، 20 أداة متخصصة

كل أداة يحتاجها المساعد هي استدعاء JSON بعيد. يكشف الخادم عن أربع مجموعات: البحث وتحليل الدوال وإنشاء الأكواد والوصول إلى SkySpark المباشر. كل منها أداة MCP من الدرجة الأولى، قابلة للاكتشاف عبر tools/list.

الأدوات تنحط بأناقة. إذا كان اتصال SkySpark معطلاً، فإن أدوات البحث والتحليل تستمر في العمل دون اتصال مقابل الفهرس المحلي.

أدوات MCP (~20) tools/list
بحث
استعلامات FlexSearch عبر المستندات والمشغلين والأنماط.
searchAxonExamples searchAxonDocs searchAxonOperatorExamples searchAxonRegex listAxonCategories getAxonExample getAxonPattern listAxonPatterns
دوال
البحث عن الاستخدام وتحليل رسم البيانات ثنائي الاتجاه للاستدعاءات.
findFunctionUsage getFunctionExamples getFunctionCallGraph getFunctionUsageStats
إنشاء
تجميع الأكواد المكتوبة مع المشي في AST والتحقق المسبق.
generateAxonCode validateAxonCode parseAxonAst listAxonTemplates
SkySpark
استعلامات Haystack المباشرة وتنفيذ Axon عبر OAuth 2.1.
queryHaystack executeAxonCode listSkySparkProjects switchSkySparkProject
رسم بيانات للاستدعاءات occSchedule() -- عمق 2
المستدعيون
hvacRuntime
تم الاستدعاء 12x
energyReport
تم الاستدعاء 3x
sparkOccAnomaly
تم الاستدعاء 7x
occSchedule()
دالة
المستدعاة
dayOfWeek
يستدعي 4x
now
يستدعي 1x
3
إجمالي المستدعيين
2
إجمالي المستدعاة
4
أقصى عمق

تحليل الدوال

ثنائي الاتجاه بالتصميم

findFunctionUsage يجد كل موقع استدعاء. getFunctionCallGraph يبني شجرة التبعية -- من يستدعي هذه الدالة وما تستدعيه -- في مسار واحد. getFunctionUsageStats يجمع قاعدة الأكواد بأكملها.

الفهرسة تعمل بشكل تدريجي. احفظ ملفاً، الرسم البياني يُحدَّث. تصبح كل دالة في قاعدة أكواد Axon قابلة للاستعلام مع الحفاظ على السياق الكامل.

  • ✓ حل المستدعيين عبر مجموعات الأدوات
  • ✓ حل المستدعاة مع حد العمق
  • ✓ كشف الدوال غير المستخدمة
  • ✓ إحصائيات الدالة الأكثر استدعاءً

إنشاء الأكواد

إنشاء وتحليل والتحقق -- كل مرة

generateAxonCode يوليد Axon مكتوب من نية اللغة الطبيعية. parseAxonAst يمشي في النتيجة. validateAxonCode يفحص الدلالات والمشغلين والأنواع مقابل مكتبة المعايير المفهرسة. فقط الإخراج المتحقق منه يصل إلى المساعد.

الحلقة تعمل في استدعاء أداة واحد. إذا فشل التحقق، يسطح الخادم انتهاك القاعدة المحدد بحيث يمكن للمساعد إصلاحها وإعادة المحاولة.

تشغيل إنشاء الأكواد تم التحقق
طلب
{
  "pattern": "تجميع الطاقة اليومي",
  "projectContext": "building-a"
}
تم الإنشاء
// تجميع يومي حسب الموقع
(siteRef, startDate, endDate) =>
site: read(^siteRef),
meter: readAll(siteRef==site->id and elec and meter),
hist: meter.hisRead(startDate..endDate),
daily: hist.hisRollup(avg, 1day),
out: daily.addColumns({
site: site->dis,
unit: "kWh"
})
التحقق
✓ تم تحليل AST ✓ تم التحقق من الأنواع ✓ تم حل 4 مشغلين ✓ مؤسس في 3 أمثلة
نسخ SkySpark 3 موثوقة
hq-prod
skyspark.example.com
campus-main
auth: قبل 12 دقيقة
campus-staging
staging.example.com
central-plant
auth: قبل 48 دقيقة
lab-dev
إعادة الاتصال
lab.internal
sandbox
auth: قبل ساعتين
نتيجة التنفيذ
read(site and campus).hisRead(today)
الموقع معدات قيمة
campus-main ahu-1 72.3°F
campus-main ahu-2 74.1°F
campus-main zone-core 71.8°F

المصادقة متعددة النسخ

من المعرفة إلى الإجراء

رموز OAuth 2.1 لكل نسخة SkySpark. listSkySparkProjects يكتشفها. switchSkySparkProject يربط الواحد النشط. executeAxonCode ينفذ ضده.

الرموز تعيش في SQLite عبر Prisma. يحدث التحديث تلقائياً. النسخ الاحتياطي والاستعادة مدمجة بحيث لا ينعكس الانتقال بين أجهزة الكمبيوتر المحمول على إعادة المصادقة لعشرة مبانٍ.

3
نسخ
14
مشاريع
2،841
دوال معروضة

هل أنت مهتم بهذا المشروع؟

استكشف الكود المصدري، ساهم، أو تواصل معنا.

عرض على GitHub تواصل معنا