تكامل خادم ClickHouse MCP

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

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

قائمة القوالب

لا توجد قوالب أوامر مذكورة في المستودع أو التوثيق.

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

لا توجد موارد صريحة موصوفة في التوثيق المتاح.

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

• run_select_query
  تنفيذ استعلامات SQL على مجموعة ClickHouse الخاصة بك في وضع آمن للقراءة فقط. يقبل إدخال sql (سلسلة نصية) يمثل استعلام SQL المراد تنفيذه.

• list_databases
  يعرض جميع قواعد البيانات المتاحة على مجموعة ClickHouse الخاصة بك.

• list_tables
  يعرض جميع الجداول داخل قاعدة بيانات محددة. يتطلب إدخال database (سلسلة نصية) لتحديد قاعدة البيانات المراد استعراضها.

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

• إدارة واستكشاف قواعد البيانات
  اعرض بسهولة جميع القواعد والجداول لفهم بنية ومخطط نشر ClickHouse لديك بسرعة.

• تنفيذ الاستعلامات المؤتمتة
  نفذ استعلامات SQL للقراءة فقط بشكل برمجي، مما يمكّن وكلاء الذكاء الاصطناعي من جلب البيانات وتحليلها وتلخيصها لأغراض التحليل أو التقارير.

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

• أتمتة التحليلات الآمنة
  تنفيذ مهام التحليل مع فرض الوصول للقراءة فقط، لضمان سلامة البيانات والالتزام بسياسات الأمان.

• تكامل مع الوكلاء المدعومين بالذكاء الاصطناعي
  تمكين المساعدين الذكيين من التفاعل مباشرة مع ClickHouse لجلب البيانات، مما يعزز قدرات الدردشة، والمساعدين، أو أدوات أتمتة سير العمل.

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

Windsurf

لا توجد تعليمات إعداد لـ Windsurf في التوثيق.

Claude

1. افتح ملف إعدادات Claude Desktop:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

2. أضف التكوين التالي إلى قسم mcpServers:

   {
     "mcpServers": {
       "mcp-clickhouse": {
         "command": "uv",
         "args": [
           "run",
           "--with",
           "mcp-clickhouse",
           "--python",
           "3.13",
           "mcp-clickhouse"
         ],
         "env": {
           "CLICKHOUSE_HOST": "<clickhouse-host>",
           "CLICKHOUSE_PORT": "<clickhouse-port>",
           "CLICKHOUSE_USER": "<clickhouse-user>",
           "CLICKHOUSE_PASSWORD": "<clickhouse-password>",
           "CLICKHOUSE_SECURE": "true",
           "CLICKHOUSE_VERIFY": "true",
           "CLICKHOUSE_CONNECT_TIMEOUT": "30",
           "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
         }
       }
     }
   }
   

3. استبدل القيم الرمزية بمعلومات الدخول الخاصة بـ ClickHouse.

4. حدّث مسار الأمر لـ uv إلى المسار المطلق لملف uv التنفيذي الخاص بك.

5. أعد تشغيل Claude Desktop لتطبيق التغييرات.

مثال لـ ClickHouse SQL Playground:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.13",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_PORT": "8443",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": "",
        "CLICKHOUSE_SECURE": "true",
        "CLICKHOUSE_VERIFY": "true",
        "CLICKHOUSE_CONNECT_TIMEOUT": "30",
        "CLICKHOUSE_SEND_RECEIVE_TIMEOUT": "30"
      }
    }
  }
}

Cursor

لا توجد تعليمات إعداد لـ Cursor في التوثيق.

Cline

لا توجد تعليمات إعداد لـ Cline في التوثيق.

ملاحظة:
يجب توفير جميع بيانات اعتماد ClickHouse عبر متغيرات البيئة في قسم env من إعدادات JSON، لضمان عدم تضمين معلومات حساسة كالمفاتيح أو كلمات المرور بشكل صريح في الكود.

مثال (متغيرات البيئة لبيانات الاعتماد):

"env": {
  "CLICKHOUSE_HOST": "<clickhouse-host>",
  "CLICKHOUSE_PORT": "<clickhouse-port>",
  "CLICKHOUSE_USER": "<clickhouse-user>",
  "CLICKHOUSE_PASSWORD": "<clickhouse-password>"
}

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

استخدام MCP في FlowHunt

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

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

{
  "mcp-clickhouse": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، سيتمكن وكيل الذكاء الاصطناعي من استخدام هذا MCP كأداة مع إمكانية الوصول إلى جميع وظائفه وقدراته. تذكر تغيير "mcp-clickhouse" إلى اسم خادم MCP الفعلي الخاص بك واستبدال عنوان URL بعنوان خادم MCP الخاص بك.

نظرة عامة

رأينا

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

تقييم MCP

التقييم النهائي:
استنادًا إلى اكتمال التوثيق ووضوح الأدوات والترخيص المفتوح وتفاعل المجتمع، ولكن مع مراعاة الأقسام الناقصة حول القوالب والموارد ودعم الإعداد متعدد المنصات: 6/10