> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-postgresql-tls-support.mintlify.site/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>
    ## تثبيت uv

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

  <Step>
    ## تشغيل Open WebUI

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

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

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

  <Step>
    ## إعداد 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/0_endpoints.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=663fde71ecbe79a317e94e4e54fbe0c5" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/1_settings.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=b49a5a8385e5fc9ed2e95e2781791c79" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/2_tools_page.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=c3a0eaa59efc53b43a4511519763920b" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/3_add_tool.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=9554c5c27dd8a5fca0ba9d8daafa6138" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/4_tools_available.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=50f53229d37f390435b3c4b835be44a4" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/5_list_of_tools.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=0804e74e7add289b14fef61034712eca" alt="قائمة أدوات Open WebUI" size="md" width="1373" height="711" data-path="images/use-cases/AI_ML/MCP/5_list_of_tools.webp" />
  </Step>

  <Step>
    ## إعداد OpenAI

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

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/6_connections.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=461b62eb9e70575480d5291cdd359300" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/7_add_connection.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=49912d1d5247fef03ef624c190944b55" 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-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/8_openai_models_more.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=ffb6c32079ab053f9ad89f8bca6a404b" alt="Open WebUI - النماذج" size="md" width="1574" height="1248" data-path="images/use-cases/AI_ML/MCP/8_openai_models_more.webp" />
  </Step>

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

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

    <Image img="https://mintcdn.com/private-7c7dfe99-postgresql-tls-support/rCN1jCVQ42dRy0Wp/images/use-cases/AI_ML/MCP/9_conversation.webp?fit=max&auto=format&n=rCN1jCVQ42dRy0Wp&q=85&s=f56c69cc8d0fc903c1c83e392cc8ac8c" 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>
