Usando o servidor MCP do ClickHouse com o AnythingLLM

Este guia explica como configurar o AnythingLLM com um servidor MCP do ClickHouse usando Docker e conectá-lo aos datasets de exemplo do ClickHouse.

Instale o Docker

Você precisará do Docker para executar o LibreChat e o servidor MCP. Para obter o Docker:

Acesse docker.com
Baixe o Docker Desktop para o seu sistema operacional
Instale o Docker seguindo as instruções para o seu sistema operacional
Abra o Docker Desktop e verifique se ele está em execução

Para mais informações, consulte a documentação do Docker.

Baixe a imagem Docker do AnythingLLM

Execute o comando a seguir para baixar a imagem Docker do AnythingLLM para a sua máquina:

docker pull anythingllm/anythingllm

Configure o local de armazenamento

Crie um diretório para armazenamento e inicialize o arquivo de ambiente:

export STORAGE_LOCATION=$PWD/anythingllm && \
mkdir -p $STORAGE_LOCATION && \
touch "$STORAGE_LOCATION/.env" 

Configure o arquivo de configuração do servidor MCP

Crie o diretório plugins:

mkdir -p "$STORAGE_LOCATION/plugins"

Crie um arquivo chamado anythingllm_mcp_servers.json no diretório plugins e adicione o conteúdo a seguir:

{
  "mcpServers": {
    "mcp-clickhouse": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp-clickhouse",
        "--python",
        "3.10",
        "mcp-clickhouse"
      ],
      "env": {
        "CLICKHOUSE_HOST": "sql-clickhouse.clickhouse.com",
        "CLICKHOUSE_USER": "demo",
        "CLICKHOUSE_PASSWORD": ""
      }
    }
  }
}

Se você quiser explorar seus próprios dados, pode fazer isso usando o host, nome de usuário e senha do seu próprio ClickHouse Cloud service.

Inicie o contêiner Docker do AnythingLLM

Execute o comando a seguir para iniciar o contêiner Docker do AnythingLLM:

docker run -p 3001:3001 \
--cap-add SYS_ADMIN \
-v ${STORAGE_LOCATION}:/app/server/storage \
-v ${STORAGE_LOCATION}/.env:/app/server/.env \
-e STORAGE_DIR="/app/server/storage" \
mintplexlabs/anythingllm

Quando ele iniciar, acesse http://localhost:3001 no navegador. Selecione o modelo que deseja usar e forneça sua API key.

Aguarde a inicialização dos servidores MCP

Clique no ícone de ferramenta no canto inferior esquerdo da UI:Clique em Agent Skills e procure a seção MCP servers. Aguarde até ver Mcp ClickHouse definido como On

Converse com o servidor MCP do ClickHouse no AnythingLLM

Agora estamos prontos para iniciar um chat. Para disponibilizar os servidores MCP em um chat, você precisará adicionar o prefixo @agent à primeira mensagem da conversa.

​Instale o Docker

​Baixe a imagem Docker do AnythingLLM

​Configure o local de armazenamento

​Configure o arquivo de configuração do servidor MCP

​Inicie o contêiner Docker do AnythingLLM

​Aguarde a inicialização dos servidores MCP

​Converse com o servidor MCP do ClickHouse no AnythingLLM