استخدام خادم ClickHouse MCP مع Claude Desktop

يوضح هذا الدليل كيفية إعداد Claude Desktop مع ClickHouse MCP server باستخدام uv وتوصيله بمجموعات بيانات ClickHouse التجريبية.

تثبيت uv

ستحتاج إلى تثبيت uv لاتباع التعليمات الواردة في هذا الدليل. إذا كنت لا ترغب في استخدام uv، فستحتاج إلى تحديث إعدادات ClickHouse MCP server لاستخدام مدير حزم بديل.

تنزيل Claude Desktop

ستحتاج أيضًا إلى تثبيت تطبيق Claude Desktop، ويمكنك تنزيله من موقع Claude Desktop.

إعداد ClickHouse MCP server

بمجرد تثبيت Claude Desktop، يحين وقت إعداد ClickHouse MCP server. يمكننا القيام بذلك عبر ملف إعداد Claude Desktop.للعثور على هذا الملف، انتقل أولًا إلى صفحة الإعدادات (Cmd+, على جهاز Mac)، ثم انقر على علامة التبويب Developer في القائمة اليسرى. بعد ذلك ستظهر لك الشاشة التالية، حيث ستحتاج إلى النقر على الزر Edit config:سينقلك هذا إلى دليل يحتوي على ملف الإعداد (claude_desktop_config.json). وعند فتح هذا الملف لأول مرة، فمن المرجح أن يحتوي على المحتوى التالي:

{
  "mcpServers": {}
}

يستخدم قاموس mcpServers اسم خادم MCP كمفتاح، وقاموسًا لخيارات الإعداد كقيمة. على سبيل المثال، سيبدو إعداد ClickHouse MCP server المتصل بـ ClickHouse Playground كما يلي:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "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"
      }
    }
  }
}

بمجرد تحديث الإعداد، ستحتاج إلى إعادة تشغيل Claude Desktop حتى تصبح التغييرات سارية.

بحسب الطريقة التي ثبّتَّ بها uv، قد يظهر لك الخطأ التالي عند إعادة تشغيل Claude Desktop:

MCP mcp-clickhouse: spawn uv ENOENT

إذا حدث ذلك، فستحتاج إلى تحديث command ليحتوي على المسار الكامل إلى uv. على سبيل المثال، إذا كنت قد ثبّتَّه عبر Cargo، فسيكون /Users/<username>/.cargo/bin/uv

استخدام ClickHouse MCP server

بعد إعادة تشغيل Claude Desktop، يمكنك العثور على ClickHouse MCP server بالنقر على أيقونة Search and tools:
يمكنك بعد ذلك اختيار ما إذا كنت تريد تعطيل كل الأدوات أو بعضها.الآن أصبحنا جاهزين لطرح بعض الأسئلة على Claude، ما سيؤدي إلى استخدامه ClickHouse MCP server. على سبيل المثال، يمكننا أن نسأله: What's the most interesting dataset in the SQL playground?.سيطلب Claude منا تأكيد استخدام كل أداة في خادم MCP عند استدعائها لأول مرة:فيما يلي يمكنك رؤية جزء من محادثة يتضمن بعض استدعاءات الأدوات إلى ClickHouse MCP server:

آخر تعديل في ٣ يوليو ٢٠٢٦

تكامل LibreChatيشرح هذا الدليل كيفية إعداد LibreChat باستخدام خادم ClickHouse MCP عبر Docker.

​تثبيت uv

​تنزيل Claude Desktop

​إعداد ClickHouse MCP server

​استخدام ClickHouse MCP server

تثبيت uv

تنزيل Claude Desktop

إعداد ClickHouse MCP server

استخدام ClickHouse MCP server