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

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

Установка uv

Чтобы следовать инструкциям в этом руководстве, вам потребуется установить uv. Если вы не хотите использовать uv, вам потребуется обновить config MCP-сервера для использования альтернативного менеджера пакетов.

Запуск Open WebUI

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

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

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

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

Чтобы настроить MCP-сервер ClickHouse, нам нужно будет представить интерфейс 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, но мы также можем добавить конечные точки, совместимые с OpenAI. Они настраиваются через меню настроек, но на этот раз нужно нажать на вкладку Connections: