Como usar o servidor MCP do ClickHouse com o Open WebUI

Você precisará instalar o uv para seguir as instruções deste guia. Se não quiser usar o uv, será necessário atualizar a config do servidor MCP para usar um gerenciador de pacotes alternativo.

Para iniciar o Open WebUI, você pode executar o seguinte comando:

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

Acesse http://localhost:8080/ para ver a UI.

Para configurar o servidor MCP do ClickHouse, precisaremos converter o servidor MCP em endpoints OpenAPI. Primeiro, vamos definir variáveis de ambiente que nos permitirão conectar ao playground SQL do ClickHouse:

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

Em seguida, podemos executar mcpo para criar os endpoints OpenAPI:

uvx mcpo --port 8000 -- uv run --with mcp-clickhouse --python 3.10 mcp-clickhouse

Você pode ver uma lista dos endpoints criados acessando http://localhost:8000/docs

Para usar esses endpoints com o Open WebUI, precisamos ir até as configurações:

Clique em Tools:

Adicione http://localhost:8000 como URL da ferramenta:

Depois de fazer isso, deveremos ver um 1 ao lado do ícone da ferramenta na barra de chat:

Se clicarmos no ícone da ferramenta, poderemos listar as ferramentas disponíveis:

Por padrão, o Open WebUI funciona com modelos do Ollama, mas também podemos adicionar endpoints compatíveis com OpenAI. Eles são configurados pelo menu de configurações, mas desta vez precisamos clicar na aba Connections:

Vamos adicionar o endpoint e nossa chave da OpenAI:

Os modelos da OpenAI ficarão disponíveis no menu superior:

Em seguida, podemos iniciar uma conversa, e o Open WebUI acionará o servidor MCP se necessário: