Использование MCP-сервера ClickHouse с Open WebUI

В данном руководстве описывается настройка Open WebUI с MCP-сервером ClickHouse и подключение к примерам наборов данных ClickHouse.

Установите uv

Вам нужно установить uv, чтобы выполнить инструкции из этого руководства. Если вы не хотите использовать uv, вам потребуется обновить конфигурацию MCP Server, чтобы использовать другой менеджер пакетов.

Запуск Open WebUI

Чтобы запустить Open WebUI, выполните следующую команду:

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

Перейдите по адресу http://localhost:8080/, чтобы открыть веб-интерфейс.

Настройка сервера ClickHouse MCP

Чтобы настроить сервер ClickHouse MCP, нам нужно будет представить интерфейс сервера MCP в виде конечных точек OpenAPI. Сначала зададим переменные окружения, которые позволят нам подключиться к ClickHouse SQL Playground:

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

Теперь можно запустить mcpo, чтобы создать эндпоинты OpenAPI:

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 рядом с иконкой инструмента на панели чата:

Если нажать на иконку инструмента, отобразится список доступных инструментов:

Настройка OpenAI

По умолчанию Open WebUI работает с моделями Ollama, но мы также можем добавить конечные точки API, совместимые с OpenAI. Они настраиваются через меню настроек, но в этот раз нам нужно перейти на вкладку Connections: