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

Установите uv

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

Запустите Open WebUI

Чтобы запустить Open WebUI, выполните следующую команду:
Перейдите по адресу http://localhost:8080/, чтобы открыть интерфейс.
3

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

Чтобы настроить MCP-сервер ClickHouse, нам нужно преобразовать его в конечные точки OpenAPI. Сначала зададим переменные окружения, которые позволят подключиться к Песочнице ClickHouse:
Затем можно запустить mcpo, чтобы создать конечные точки OpenAPI:
Список созданных конечных точек можно увидеть, перейдя по адресу http://localhost:8000/docs
Конечные точки OpenAPI
Чтобы использовать эти конечные точки в Open WebUI, перейдите в настройки:
Настройки Open WebUI
Нажмите Tools:
Инструменты Open WebUI
Добавьте http://localhost:8000 как URL инструмента:
Инструмент Open WebUI
После этого рядом со значком инструмента на панели чата должна появиться цифра 1:
Доступные инструменты Open WebUI
Если нажать на значок инструмента, можно будет увидеть список доступных инструментов:
Список инструментов Open WebUI
4

Настройте OpenAI

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

Общайтесь с MCP-сервером ClickHouse через Open WebUI

После этого можно начать диалог, и Open WebUI при необходимости обратится к MCP-серверу:
Open WebUI — чат с MCP-сервером ClickHouse