В этом руководстве объясняется, как настроить 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:Затем можно запустить Список созданных конечных точек можно увидеть, перейдя по адресу http://localhost:8000/docs
Чтобы использовать эти конечные точки в Open WebUI, перейдите в настройки:
Нажмите 
Добавьте http://localhost:8000 как URL инструмента:
После этого рядом со значком инструмента на панели чата должна появиться цифра 
Если нажать на значок инструмента, можно будет увидеть список доступных инструментов:
mcpo, чтобы создать конечные точки OpenAPI:

Tools:

1:

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


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