خادم Apache IoTDB MCP

ماذا يفعل خادم “IoTDB” MCP؟

يُعد خادم Apache IoTDB MCP تنفيذًا لبروتوكول سياق النموذج (MCP) ويهدف إلى توفير تفاعل سلس مع قاعدة البيانات وإمكانات تحليل الأعمال عبر IoTDB، وهي قاعدة بيانات سلاسل زمنية. من خلال عمله كجسر، يتيح لمساعدي الذكاء الاصطناعي والعملاء تنفيذ استعلامات SQL على IoTDB، ويدعم مهام تحليل البيانات والإدارة مباشرة عبر اللغة الطبيعية أو سير عمل برمجي مدفوع بالنماذج اللغوية. يمكن للمطورين استخدام خادم MCP لإجراء استعلامات قواعد البيانات، وعرض معلومات المخطط، واسترجاع البيانات الوصفية، مما يعزز قدرتهم على دمج IoTDB في بيئات تطوير مدعومة بالذكاء الاصطناعي لمهام مثل استعلام بيانات السلاسل الزمنية وإدارة المخططات.

قائمة التعليمات (Prompts)

الخادم لا يوفر أي تعليمات.

قائمة الموارد

الخادم لا يعرض أي موارد.

قائمة الأدوات

يقدم خادم IoTDB MCP أدوات مختلفة حسب لهجة SQL المختارة (“شجري” أو “جدولي”).

نموذج الشجرة

• metadata_query
  • ينفذ استعلامات SHOW/COUNT لاسترجاع البيانات الوصفية من قاعدة بيانات IoTDB.
  • المدخل: query_sql (نص) – استعلام SQL من نوع SHOW/COUNT للتنفيذ.
  • المخرج: نتائج الاستعلام كمصفوفة من الكائنات.
• select_query
  • ينفذ استعلامات SELECT لقراءة بيانات السلاسل الزمنية من قاعدة البيانات.
  • المدخل: query_sql (نص) – استعلام SQL من نوع SELECT للتنفيذ.
  • المخرج: نتائج الاستعلام كمصفوفة من الكائنات.

نموذج الجدول

أدوات الاستعلام

• read_query
  • ينفذ استعلامات SELECT لقراءة البيانات من قاعدة البيانات.
  • المدخل: query (نص) – استعلام SQL من نوع SELECT للتنفيذ.
  • المخرج: نتائج الاستعلام كمصفوفة من الكائنات.

أدوات المخطط

• list_tables
  • يسترجع قائمة بجميع الجداول في قاعدة البيانات.
  • المدخل: لا شيء.
  • المخرج: مصفوفة بأسماء الجداول.
• describe-table
  • يوفر معلومات مخطط عن جدول محدد.
  • المدخل: table_name (نص) – اسم الجدول المطلوب وصفه.
  • المخرج: مصفوفة بتعريفات الأعمدة مع الأسماء والأنواع.

حالات استخدام هذا الخادم MCP

• إدارة قواعد بيانات السلاسل الزمنية
  استعلام وتصفح وإدارة بيانات السلاسل الزمنية على نطاق واسع المخزنة في IoTDB مباشرة من مساعدي الذكاء الاصطناعي أو أدوات التطوير المدعومة بالنماذج اللغوية الكبيرة.
• استكشاف المخططات
  استرجاع واستكشاف مخططات قاعدة البيانات، والحصول على قوائم الجداول، وعرض أوصاف الجداول لفهم وتوثيق بنية قاعدة البيانات.
• تكامل تحليل الأعمال
  دمج بيانات IoTDB في سير عمل تحليل الأعمال مع استعلامات بلغة طبيعية وتحليل للمخططات، لتسهيل التحليلات والتقارير.
• تحليلات البيانات الآلية
  استخدم الخادم MCP كخلفية لأنابيب تحليل البيانات الآلية، حيث تنشئ النماذج اللغوية وتنفذ استعلامات SQL بناءً على نية المستخدم.
• فحص البيانات الوصفية
  تنفيذ استعلامات SHOW/COUNT لعرض البيانات الوصفية لقاعدة البيانات، مما يساعد في المراقبة والتدقيق وتحسين قاعدة البيانات.

كيفية الإعداد

Windsurf

1. تأكد من تثبيت Python ومدير الحزم uv.
2. ثبّت أو استنسخ مستودع خادم IoTDB MCP.
3. قم بتحرير ملف إعدادات Windsurf لإضافة خادم IoTDB MCP.
4. استخدم المقطع التالي بصيغة JSON في إعداداتك:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Windsurf.
6. تحقق من أن الخادم يعمل ومتصل.

Claude

1. ثبّت Python وuv وIoTDB كمتطلبات أساسية.
2. استنسخ مستودع خادم IoTDB MCP.
3. على MacOS، حرر ~/Library/Application Support/Claude/claude_desktop_config.json؛ على Windows، حرر %APPDATA%/Claude/claude_desktop_config.json.
4. أضف إدخال الخادم MCP:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. احفظ التغييرات وأعد تشغيل Claude Desktop.
6. أكد أن الخادم متاح في Claude.

Cursor

1. تأكد من تثبيت Python وuv وIoTDB.
2. استنسخ مستودع خادم MCP.
3. حرر إعدادات Cursor لتتضمن الخادم MCP.
4. استخدم المقطع التالي بصيغة JSON:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. احفظ الإعدادات وأعد تشغيل Cursor.
6. تأكد من أن الخادم MCP نشط ويستجيب.

Cline

1. ثبّت المتطلبات اللازمة: Python وuv وIoTDB.
2. استنسخ خادم Apache IoTDB MCP.
3. افتح ملف إعدادات Cline.
4. أضف بيانات الخادم MCP كما يلي:

   {
     "mcpServers": {
       "iotdb": {
         "command": "uv",
         "args": [
           "--directory",
           "YOUR_REPO_PATH/src/iotdb_mcp_server",
           "run",
           "server.py"
         ],
         "env": {
           "IOTDB_HOST": "127.0.0.1",
           "IOTDB_PORT": "6667",
           "IOTDB_USER": "root",
           "IOTDB_PASSWORD": "root",
           "IOTDB_DATABASE": "test",
           "IOTDB_SQL_DIALECT": "table"
         }
       }
     }
   }
   

5. احفظ وأعد تشغيل Cline.
6. تحقق من تكامل الخادم MCP.

حماية مفاتيح الـ API
يتم إدارة بيانات الاعتماد مثل IOTDB_USER وIOTDB_PASSWORD عبر الحقل env في الإعدادات. استخدم متغيرات البيئة لتجنب كتابة البيانات الحساسة بشكل صريح. مثال:

"env": {
  "IOTDB_HOST": "127.0.0.1",
  "IOTDB_PORT": "6667",
  "IOTDB_USER": "${IOTDB_USER}",
  "IOTDB_PASSWORD": "${IOTDB_PASSWORD}",
  "IOTDB_DATABASE": "test"
}

وقم بتعيين هذه المتغيرات في نظامك قبل بدء الخادم.

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP في سير عملك على FlowHunt، ابدأ بإضافة مكون MCP إلى التدفق الخاص بك وقم بربطه مع وكيل الذكاء الاصطناعي:

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

{
  "iotdb": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

نظرة عامة

رأينا

خادم IoTDB MCP هو تنفيذ مركّز وبسيط يوفر أدوات أساسية للتفاعل مع قاعدة بيانات IoTDB. يفتقر إلى ميزات MCP المتقدمة مثل التعليمات، والموارد، والجذور، وأخذ العينات، ولكنه مناسب تمامًا لحالته الخاصة في الوصول إلى قواعد بيانات السلاسل الزمنية. الإعداد موثق جيدًا لـ Claude Desktop؛ أما باقي التكاملات فهي استنتاجية ولكنها قياسية. بشكل عام، هذا خادم MCP متخصص لكنه قوي لسير عمل يركز على قواعد البيانات.

تقييم MCP