المادي والجغرافيالمصدر العام

SCADA MCP Server

منصة SCADA / للتحكم الصناعي لوكلاء الطاقة والمرافق في ADK-Rust Enterprise. 27 أداة MCP تغطي المواقع والأصول، علامات/نقاط القياس عن بُعد، القراءات اللحظية + مؤرخ، دورة حياة الإنذار،...

افتح المصدر اقرأ الدليل الرسمي ↗

ما الذي يقدمه للوكيل

قدرة مخصصة خلف اتصال MCP واحد.

يمتلك الخادم منطق مجاله وينشر عقد أداة يمكن لعميل MCP اكتشافه. يمكن لـ ADK-Rust تحميل هذا العقد في وكيل، تطبيع كل مخطط لمزود النموذج المختار، والحفاظ على دورة حياة الاتصال خارج منطق عمل الوكيل.

المواقع والأصول — المواقع حسب القطاع (الكهرباء/الغاز/المياه/الطاقة المتجددة)؛ الأصول بحالة التشغيل (في الخدمة/خارج الخدمة/مقفلة/معطلة) وقفل/علامة.

العلامات / النقاط — نقاط قياس وتحكم قابلة للعناوين من نوع تماثلي/حالة (للقراءة فقط) أو نقطة ضبط/تحكم (قابلة للكتابة)، مع نطاقات هندسية وعلامات تحذير/عتبات.

القياس عن بُعد والمؤرخ — ingest_reading يسجل التاريخ ويرفع/يمسح الإنذارات تلقائيًا عند العتبات؛ tag_history و tag_trend للتحليل.

الإنذارات — دورة حياة من نشط → معترف به → تم مسحه، حسب الشدة.

التحكم — issue_command يشغل سلسلة القفل ويطبق القيمة فقط عند اجتياز الكل؛ check_interlocks هو تشغيل تجريبي للقراءة فقط.

الانقطاعات — report_outage يصنف الأولوية تلقائيًا (P1 الأعلى)؛ outage_queue هو قائمة العمل مرتبة حسب الأولوية.

الصيانة — أوامر العمل (وقائية/تصحيحية/تفتيش/طوارئ) مع الجدولة والتعيين.

البنية

كيف يتناسب SCADA MCP Server مع نظام الوكيل.

لا يحتاج النموذج أبدًا إلى تفاصيل التنفيذ أو بيانات اعتماد النظام خلف الخادم. يرى تعريفات الأدوات المراجعة. يتولى عميل MCP الاكتشاف والاستدعاءات، بينما يحتفظ الخادم بملكية التحقق، السياسة، والاتصال بنظام مجاله.

وكيل ADK-Rust

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

→

عميل MCP

يكتشف المخططات، يرسل الاستدعاءات، ويتلقى المحتوى المطبوع.

→

SCADA MCP Server

يحقق في الطلب ويمتلك 27 عقود أدوات موثقة.

→

نظام المجال

يحافظ على واجهة برمجة التطبيقات، البيانات، بيانات الاعتماد، وقواعد العمل خلف الخادم.

الاتصال: stdio · إطار عمل الخادم: ADK MCP SDK + rmcp

مخطط هيكلية SCADA MCP Server من مستودعه الرسمي

كتالوج الأدوات

ماذا يمكن للوكيل أن يطلب من SCADA MCP Server القيام به؟

لكل أداة اسم ثابت، غرض قابل للقراءة من قبل الإنسان، وعقد إدخال JSON يتم اكتشافه أثناء تهيئة MCP. تأتي فئات المخاطر من بيان سجل المشروع عند توفره.

27 أدوات مسماة

create_site

تسجيل موقع (محطة فرعية/منظم/مضخة/طاقة شمسية)

internal write

list_sites

قائمة المواقع حسب القطاع

read only

create_asset

تسجيل أصل في موقع

internal write

get_asset

الحصول على أصل (الحالة، القفل)

read only

list_assets

قائمة الأصول حسب الموقع/النوع/الحالة

read only

set_asset_state

تعيين حالة تشغيل الأصل (يؤثر على أقفال التحكم)

external write

set_lockout

تطبيق/إزالة القفل والعلامة (يمنع التحكم)

external write

create_tag

تعريف علامة/نقطة (تماثلي/حالة/نقطة ضبط/تحكم)

internal write

get_tag

الحصول على قيمة العلامة، النطاقات، العتبات

read only

list_tags

قائمة علامات الأصل مع القيم الحية

read only

ingest_reading

استيعاب قراءة قياس عن بُعد (تقييم إنذار تلقائي)

internal write

tag_history

تاريخ القراءات لعلامة

read only

الحوكمة

افهم تأثير كل أداة.

يرث اتصال الخادم سلطة بيانات الاعتماد وبيئة النشر الخاصة به. التصريحات أدناه مأخوذة من ملف README الخاص بهذا المشروع وبيان سجل MCP؛ لا يزال تطبيقك يقرر الأدوات التي يتلقاها الوكيل وأين يتطلب الأمر الموافقة.

13 read only11 internal write3 external write

سلسلة القفل على كل أمر (issue_command)، يتم التحقق منها بالترتيب؛ تُطبق القيمة فقط إذا اجتاز الجميع، ويتم تسجيل الأمر المرفوض لكنه لا يُنفذ:
تشغيل تجريبي أولاً — check_interlocks (للقراءة فقط) يسمح للوكيل بتأكيد الجدوى قبل طلب أمر يتطلب الموافقة.
الكتابات الخارجية التي تتطلب الموافقة — issue_command، set_lockout، و set_asset_state هي external_write + requires_approval في البيان؛ مستوى المخاطر = "حرج".
سجل تدقيق كامل — يتم تسجيل كل أمر (منفذ ومرفوض) وتغيير حالة (command_history، audit_log).
محرك مرجعي — هذا تنفيذ مرجعي في الذاكرة. يجب على النشر الإنتاجي فرض هذه الأقفال أيضًا على مستوى RTU/PLC/الميدان ومن خلال الأجهزة...

واجهة MCP

ما تعلنه الوثائق الحالية.

يمكن لـ MCP حمل الأدوات، الموارد، المطالبات، النتائج المنظمة، التقدم، الإلغاء، والعمل طويل الأمد. يبرز هذا السجل ميزات البروتوكول الحديثة المذكورة صراحة في هذا المستودع.

يركز README الحالي على واجهة الأدوات الخاصة به. تحقق من المصدر وملاحظات الإصدار قبل الاعتماد على قدرات MCP الاختيارية بخلاف اكتشاف الأدوات واستدعائها.

ADK MCP SDKrmcpبيان السجل

التثبيت والاتصال

اتبع نقطة البداية الموثقة للمشروع.

ثبت الخادم في البيئة التي تمتلك بيانات الاعتماد والوصول إلى المجال. أضفه إلى مضيف MCP الخاص بك، تحقق من الأدوات المكتشفة، وقم بتضييق مجموعة الأدوات قبل تسليمها لوكيل الإنتاج.

تثبيت

cargo install mcp-scada

شكل اتصال ADK-Rust

let toolset = McpToolset::from_stdio(
    "mcp-scada",
    ["mcp-scada"],
).await?;

let agent = LlmAgentBuilder::new("agent")
    .tools(toolset.tools().await?)
    .build()?;

يتم استخراج الأوامر والتكوين من ملف README العام. تحقق من المتطلبات المسبقة، متغيرات البيئة، وخيارات الإصدار المحددة في الوثائق الرسمية قبل النشر.

الوثائق الرسمية

تابع مصدر الحقيقة الخاص بصانعي المشروع.

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

نظرة عامة ↗README.md سجل التغييرات ↗CHANGELOG.md الهيكلية ↗docs/architecture.svg المشكلات والدعم ↗مشكلات github.com

استمر في الاستكشاف

SCADA MCP Server

قدرة مخصصة خلف اتصال MCP واحد.

كيف يتناسب SCADA MCP Server مع نظام الوكيل.

وكيل ADK-Rust

عميل MCP

SCADA MCP Server

نظام المجال

الهيكلية المنشورة للخادم

ماذا يمكن للوكيل أن يطلب من SCADA MCP Server القيام به؟

افهم تأثير كل أداة.

ما تعلنه الوثائق الحالية.

اتبع نقطة البداية الموثقة للمشروع.

تابع مصدر الحقيقة الخاص بصانعي المشروع.

المزيد في المادي والجغرافي.