> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# استخدام خادم ClickHouse MCP مع Claude Desktop
> يوضح هذا الدليل كيفية إعداد Claude Desktop مع خادم ClickHouse MCP.
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return
;
};
> يوضح هذا الدليل كيفية إعداد Claude Desktop مع ClickHouse MCP server باستخدام uv
> وتوصيله بمجموعات بيانات ClickHouse التجريبية.
ستحتاج إلى تثبيت [uv](https://docs.astral.sh/uv/) لاتباع التعليمات الواردة في هذا الدليل.
إذا كنت لا ترغب في استخدام uv، فستحتاج إلى تحديث إعدادات خادم MCP لاستخدام مدير حزم بديل.
ستحتاج أيضًا إلى تثبيت تطبيق Claude Desktop، ويمكنك تنزيله من [موقع Claude Desktop](https://claude.ai/desktop).
بمجرد تثبيت Claude Desktop، يحين وقت إعداد [خادم ClickHouse MCP](https://github.com/ClickHouse/mcp-clickhouse).
يمكننا القيام بذلك عبر [ملف إعداد Claude Desktop](https://claude.ai/docs/configuration).
للعثور على هذا الملف، انتقل أولًا إلى صفحة الإعدادات (`Cmd+,` على جهاز Mac)، ثم انقر على علامة التبويب `Developer` في القائمة اليسرى.
بعد ذلك ستظهر لك الشاشة التالية، حيث ستحتاج إلى النقر على الزر `Edit config`:
سينقلك هذا إلى دليل يحتوي على ملف الإعداد (`claude_desktop_config.json`).
وعند فتح هذا الملف لأول مرة، فمن المرجح أن يحتوي على المحتوى التالي:
```json theme={null}
{
"mcpServers": {}
}
```
يستخدم قاموس `mcpServers` اسم خادم MCP كمفتاح، وقاموسًا لخيارات الإعداد كقيمة.
على سبيل المثال، سيبدو إعداد خادم ClickHouse MCP المتصل بـ ClickHouse Playground كما يلي:
```json theme={null}
{
"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:
```text theme={null}
MCP mcp-clickhouse: spawn uv ENOENT
```
إذا حدث ذلك، فستحتاج إلى تحديث `command` ليحتوي على المسار الكامل إلى `uv`. على سبيل المثال، إذا كنت قد ثبّتَّه عبر Cargo، فسيكون `/Users//.cargo/bin/uv`
بعد إعادة تشغيل Claude Desktop، يمكنك العثور على خادم ClickHouse MCP بالنقر على أيقونة `Search and tools`:
يمكنك بعد ذلك اختيار ما إذا كنت تريد تعطيل كل الأدوات أو بعضها.
الآن أصبحنا جاهزين لطرح بعض الأسئلة على Claude، ما سيدفعه إلى استخدام خادم ClickHouse MCP.
على سبيل المثال، يمكننا أن نسأله: `What's the most interesting dataset in the SQL playground?`.
سيطلب Claude منا تأكيد استخدام كل أداة في خادم MCP عند استدعائها لأول مرة:
فيما يلي يمكنك رؤية جزء من محادثة يتضمن بعض استدعاءات الأدوات إلى خادم ClickHouse MCP: