خادم Axon MCP

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

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

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

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

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

السبب في وجوده

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

من يستخدمه

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

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

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

4,187 وثيقة. بحث أقل من 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

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

وقت التشغيل equip rollup
zoneTempRollup hvac
0.82

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

hisRead rollup يومي
energyBaseline طاقة
0.76

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

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

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

نقطة كتابة نقطة تحكم
عرض 5 من 1,488 تطابق -- مفهرسة منذ 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
تم استدعاؤه 12 مرة
energyReport
تم استدعاؤه 3 مرات
sparkOccAnomaly
تم استدعاؤه 7 مرات
occSchedule()
دالة
المستدعيون
dayOfWeek
يستدعي 4 مرات
now
يستدعي مرة واحدة
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
مصادقة: قبل 12 دقيقة
campus-staging
staging.example.com
central-plant
مصادقة: قبل 48 دقيقة
lab-dev
إعادة الاتصال
lab.internal
sandbox
مصادقة: قبل ساعتين
نتيجة التنفيذ
read(site and campus).hisRead(today)
الموقع equip val
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 تواصل معنا