> ## 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 مع Open WebUI

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

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

> يشرح هذا الدليل كيفية إعداد [Open WebUI](https://github.com/open-webui/open-webui) مع ClickHouse MCP server
> وتوصيله بمجموعات البيانات التجريبية في ClickHouse.

<Steps>
  <Step title="تثبيت uv" id="install-uv">
    ستحتاج إلى تثبيت [uv](https://docs.astral.sh/uv/) لاتباع الإرشادات الواردة في هذا الدليل.
    إذا كنت لا ترغب في استخدام uv، فستحتاج إلى تحديث إعدادات ClickHouse MCP server لاستخدام مدير حزم بديل.
  </Step>

  <Step title="تشغيل Open WebUI" id="launch-open-webui">
    لتشغيل Open WebUI، يمكنك تنفيذ الأمر التالي:

    ```bash theme={null}
    uv run --with open-webui open-webui serve
    ```

    انتقل إلى [http://localhost:8080/](http://localhost:8080/) لعرض واجهة المستخدم.
  </Step>

  <Step title="تهيئة ClickHouse MCP server" id="configure-clickhouse-mcp-server">
    لإعداد ClickHouse MCP server، سنحتاج إلى تحويل MCP server إلى نقاط نهاية Open API.
    لنبدأ أولًا بتعيين متغيرات البيئة التي ستمكننا من الاتصال بـ ClickHouse SQL playground:

    ```bash theme={null}
    export CLICKHOUSE_HOST="sql-clickhouse.clickhouse.com"
    export CLICKHOUSE_USER="demo"
    export CLICKHOUSE_PASSWORD=""
    ```

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

    ```bash theme={null}
    uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse
    ```

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/0_endpoints.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=d7c649716695f00628ee8657fad6a8a1" alt="نقاط نهاية Open API" size="md" width="1455" height="759" data-path="images/use-cases/AI_ML/MCP/0_endpoints.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/1_settings.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=696f96fff4092e0684b83dfd4237a979" alt="إعدادات Open WebUI" size="md" width="518" height="575" data-path="images/use-cases/AI_ML/MCP/1_settings.webp" />

    انقر على `Tools`:

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/2_tools_page.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=d0599baa28fbebaf80301d11f2f59504" alt="أدوات Open WebUI" size="md" width="1829" height="1190" data-path="images/use-cases/AI_ML/MCP/2_tools_page.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/3_add_tool.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=dcf958b9eb52ad1b8b19e95c2b7428e6" alt="أداة Open WebUI" size="md" width="1838" height="1201" data-path="images/use-cases/AI_ML/MCP/3_add_tool.webp" />

    بمجرد الانتهاء من ذلك، ينبغي أن نرى `1` بجانب أيقونة الأداة في شريط الدردشة:

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/4_tools_available.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=60726c02b459783ec9309a197520314c" alt="أدوات Open WebUI المتاحة" size="md" width="1495" height="229" data-path="images/use-cases/AI_ML/MCP/4_tools_available.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/5_list_of_tools.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=06cbfa40d3de4e94cfd5151b39ad897f" alt="قائمة أدوات Open WebUI" size="md" width="1373" height="711" data-path="images/use-cases/AI_ML/MCP/5_list_of_tools.webp" />
  </Step>

  <Step title="تهيئة OpenAI" id="configure-openai">
    بشكل افتراضي، يعمل Open WebUI مع نماذج Ollama، لكن يمكننا أيضًا إضافة نقاط نهاية متوافقة مع OpenAI.
    تُضبط هذه الإعدادات عبر قائمة الإعدادات، لكن هذه المرة نحتاج إلى النقر على علامة التبويب `Connections`:

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/6_connections.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=15babadb04a4cec8f98e5ad0c5df0347" alt="اتصالات Open WebUI" size="md" width="1824" height="1184" data-path="images/use-cases/AI_ML/MCP/6_connections.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/7_add_connection.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=0404fce2bd39187a801fa14643ed6e40" alt="Open WebUI - إضافة OpenAI كاتصال" size="md" width="1821" height="1192" data-path="images/use-cases/AI_ML/MCP/7_add_connection.webp" />

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

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/8_openai_models_more.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=e829a594b93d98e3e3d52667f567d9a6" alt="Open WebUI - النماذج" size="md" width="1574" height="1248" data-path="images/use-cases/AI_ML/MCP/8_openai_models_more.webp" />
  </Step>

  <Step title="الدردشة مع ClickHouse MCP server باستخدام Open WebUI" id="chat-to-clickhouse-mcp-server">
    يمكننا بعد ذلك بدء محادثة، وسيتواصل Open WebUI مع MCP server إذا لزم الأمر:

    <Image img="https://mintcdn.com/private-7c7dfe99/F7iOqwDUBB9E2S65/images/use-cases/AI_ML/MCP/9_conversation.webp?fit=max&auto=format&n=F7iOqwDUBB9E2S65&q=85&s=177845ba46da7b871bd637081d7275b0" alt="Open WebUI - الدردشة مع ClickHouse MCP server" size="md" width="2449" height="1839" data-path="images/use-cases/AI_ML/MCP/9_conversation.webp" />
  </Step>
</Steps>
