استخدام خادم ClickHouse MCP مع Open WebUI

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

يشرح هذا الدليل كيفية إعداد Open WebUI مع ClickHouse MCP server وربطه بمجموعات البيانات التجريبية في ClickHouse.

1. ​

   تثبيت uv

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

2. ​

   تشغيل Open WebUI

   لتشغيل Open WebUI، يمكنك تنفيذ الأمر التالي:

   uv run --with open-webui open-webui serve
   

   انتقل إلى http://localhost:8080/ لعرض واجهة المستخدم.

3. ​

   إعداد ClickHouse MCP server

   لإعداد ClickHouse MCP server، سنحتاج إلى تحويل MCP server إلى نقاط نهاية Open API. لنبدأ أولًا بتعيين متغيرات البيئة التي ستتيح لنا الاتصال بـ ClickHouse SQL Playground:

   export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
   export CLICKHOUSE_USER="demo"
   export CLICKHOUSE_PASSWORD=""
   

   بعد ذلك، يمكننا تشغيل mcpo لإنشاء نقاط نهاية Open API:

   uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
   

   يمكنك الاطلاع على قائمة بنقاط النهاية التي تم إنشاؤها بالانتقال إلى http://localhost:8000/docs

   لاستخدام نقاط النهاية هذه مع Open WebUI، نحتاج إلى الانتقال إلى الإعدادات:

   انقر على Tools:

   أضف http://localhost:8000 باعتباره URL الأداة:

   بعد القيام بذلك، ينبغي أن يظهر 1 بجوار أيقونة الأداة في شريط الدردشة:

   إذا نقرنا على أيقونة الأداة، فسنتمكن بعد ذلك من عرض الأدوات المتاحة:

4. ​

   إعداد OpenAI

   بشكل افتراضي، يعمل Open WebUI مع نماذج Ollama، لكن يمكننا أيضًا إضافة نقاط نهاية متوافقة مع OpenAI. يتم إعداد ذلك عبر قائمة الإعدادات، لكن هذه المرة نحتاج إلى النقر على علامة التبويب Connections:

   لنُضف نقطة النهاية ومفتاح OpenAI الخاص بنا:

   ستصبح نماذج OpenAI بعد ذلك متاحة في القائمة العلوية:

5. ​

   الدردشة مع ClickHouse MCP server باستخدام Open WebUI

   يمكننا بعد ذلك بدء محادثة، وسيستدعي Open WebUI الـ MCP server عند الحاجة: