خادم Sedona MCP

الوصول الموحد متعدد البروتوكولات إلى Sedona و Sandstar و SkySpark

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

خادم MCP واحد، أربع بروتوكولات للتحكم في المباني، بدون أي رمز وسيط.

خادم Sedona MCP يتحدث Sedona Sox عبر TCP الثنائي على المنفذ 1876، و Sedona Weblet عبر HTTP على 8085، وجسر Project Haystack الخاص بـ Sandstar، و SkySpark عبر HTTPS -- كل ذلك خلف واجهة أداة MCP موحدة. اطلب منه البحث عن فئات Sedona، أو توليد رمز مكون، أو تنفيذ Axon مباشر ضد مشروع SkySpark قيد التشغيل، وستقوم طبقة التوجيه البروتوكولي بتحديد أي نقل يجب الاتصال به.

بلا اتصال، يفهرس أكثر من 27 أداة من أمثلة Sedona والمجموعات والفئات والأنماط والقوالب باستخدام FlexSearch. عند الاتصال، يصل إلى المباني الفعلية.

لماذا موجود

مكدس التحكم الحديث ليس بروتوكول واحد -- إنه أربعة، وأحيانًا خمسة. يتعامل المهندسون مع أدوات منفصلة لكل منها، فقدان السياق في كل مرة يتبدلون فيها. يطوي خادم Sedona MCP كل ذلك في محادثة واحدة: يسأل المساعد executeAxonCode والخادم يتعامل مع HTTPS بالإضافة إلى مصافحة SCRAM إلى SkySpark؛ يسأل searchSedonaClasses والخادم يصل إلى الفهرس المحلي؛ يسأل getActiveConnection والخادم يبلغ عن الجهاز المرتبط حاليًا.

من هو المستهدف

  • مهندسو التحكم الذين يعملون عبر أجهزة Sedona ومشاريع SkySpark في نفس المشروع
  • مطورو Sandstar الذين يربطون علامات Haystack بأجهزة Sedona
  • المدمجون بمساعدة الذكاء الاصطناعي الذين يريدون خادم MCP واحد، وليس أربعة

لوحة التوجيه البروتوكولي

أربع بروتوكولات، استدعاء أداة MCP واحدة

ملف إعدادات واحد يعرّف أجهزة Sox، وخوادم Weblet، وجسور Sandstar، ومثيلات SkySpark. أي استدعاء أداة يوجه إلى النقل الصحيح -- TCP الثنائي، HTTP، HTTPS -- بدون سطر واحد من رمز الربط.

التوجيه البروتوكولي
connections.json: 4 معرّفة
استدعاء أداة MCP
executeAxonCode({...})
searchSedonaClasses queryHaystack executeAxonCode getActiveConnection
Sedona Sox ثنائي
tcp:1876
بروتوكول Sox الخام عبر TCP
Sedona Weblet HTTP
http:8085
نقاط نهاية HTTP الخاصة بـ Weblet
Sandstar Haystack
http:8085
جسر Project Haystack
SkySpark HTTPS + SCRAM
https:443
تنفيذ Axon المصرح
4 بروتوكولات -- 27+ أداة -- ملف إعدادات واحد v2.0.0

سطح الأداة

ستة مجالات، واجهة واحدة

بحث، توليد، تحقق، تحليل، تنفيذ، اتصل. سبعة وعشرون أداة فأكثر منظمة حسب العملية التي تقوم بها -- وليس البروتوكول الذي تضرب عليه.

المساعد لا يحتاج إلى معرفة تنسيق السلك. يختار الأداة للمهمة. يوجه الموجّه إلى الوجهة الصحيحة.

أدوات MCP (27+) tools/list
بحث Sedona
5 أدوات
searchSedonaExamples searchSedonaClasses listSedonaKits searchSedonaRegex listSedonaCategories
توليد الرمز
3 أدوات
generateSedonaCode validateSedonaCode listSedonaTemplates
تحليل الدالة
3 أدوات
findFunctionUsage getFunctionCallGraph getFunctionUsageStats
SkySpark / Axon
4 أدوات
executeAxonCode listSkySparkProjects switchSkySparkProject discoverProjectFunctions
الجهاز / الاتصال
3 أدوات
getActiveConnection discoverInstanceProjects clearProjectCache
Haystack
1 أداة
queryHaystack
الاتصالات النشطة 4 متصلة
Sox 192.168.1.100:1876
4ms getActiveConnection منذ 3 ثوان منذ 3 ثوان
Weblet 192.168.1.100:8085
12ms searchSedonaClasses منذ 12 ثانية منذ 12 ثانية
Sandstar sandstar.internal:8085
إعادة محاولة -- queryHaystack منذ دقيقتين منذ دقيقتين
SkySpark skyspark.internal:443
127ms executeAxonCode منذ 38 ثانية منذ 38 ثانية
config/connections.json
{ "sox": { "host": "192.168.1.100", "port": 1876 }, "weblet": { "host": "192.168.1.100", "port": 8085 }, "sandstar": { "host": "sandstar.internal" }, "skyspark": { "host": "skyspark.internal", "auth": "scram" } }

الاتصالات المباشرة

أربع قضبان، لوحة تحكم واحدة

يتم تتبع كل اتصال بشكل مستقل. getActiveConnection يبلغ عن البروتوكول الذي تم استخدامه آخر مرة. discoverInstanceProjects يمشي مهما هو قابل للوصول. clearProjectCache إعادة تعيين عند انجراف شيء.

ملف الإعدادات هو المصدر الوحيد للحقيقة. أضف مثيل SkySpark جديد، أضف جهاز Sedona جديد، غيّر المنفذ -- يعيد الموجّه قراءة في استدعاء الأداة التالي.

تنفيذ SkySpark

من الكتالوج إلى المبنى

executeAxonCode ينفذ Axon التعسفي ضد مشروع SkySpark المرتبط حاليًا. listSkySparkProjects و switchSkySparkProject تدعك التجول عبر المثيلات. discoverProjectFunctions يتفحص؛ getProjectSchema يعود نموذج البيانات.

حالة المشروع تثابر. بدّل مرة واحدة، والـ 50 استدعاء أداة التالي يذهب إلى نفس المبنى. بدّل للخلف، وكانت الذاكرة مستعدة.

جسر SkySpark مباشر
executeAxonCode({ code: "read(point and zone and temp).hisRead(today)" })
النتيجة (5 صفوف، 4 أعمدة)
dis zone val ts
Zone 101core-172.3°F10:12
Zone 102core-174.1°F10:12
Zone 103core-171.8°F10:12
Zone 201core-273.4°F10:12
Zone 202core-272.9°F10:12
المشروع النشط
campus-main 42 نقطة · آخر مزامنة منذ 3 دقائق
lab 12 نقطة · آخر مزامنة منذ 18 دقيقة
qa 8 نقاط · آخر مزامنة منذ ساعة
switchSkySparkProject
جهاز Sedona Sox Binary
الجهاز النشط
المضيف192.168.1.100:1876
البروتوكولsox (ثنائي)
البرنامج الثابت1.2.28
المجموعات المحملة12
النقاط47
الحالةحسن
المجموعات المحملة (12)
sys42 فئة
control23 فئة
logic18 فئة
timing11 فئة
sensor9 فئات
datetimeStd7 فئات
inet6 فئات
types5 فئات
basicSchedule4 فئات
sox3 فئات

أجهزة Sedona

الاستطلاع من الدرجة الأولى على القضيب الثنائي

listSedonaKits يمشي بيان الجهاز. getActiveConnection يبلغ عن المضيف المرتبط. discoverInstanceProjects يقترن تلقائيًا الأجهزة المكتشفة بسياق مشروعها. Sox يتم التعامل معه كنظير HTTP، وليس نقل موروث.

ثنائي لا يعني غامض. كل فئة، كل مجموعة، كل إصدار من البرنامج الثابت مرئي للمساعد -- وقابل للبحث.

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

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

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