Repolode
Enviar
ClickHouse

ClickHouse/mcp-clickhouse

Servidor MCP que permite a assistentes de IA executar consultas SQL e explorar schemas no ClickHouse, com modo somente leitura ativado por padrão.

Ver no GitHub
Estrelas
890
Forks
210
Issues abertas
8
Último commit
há 23 horas

O que é?

mcp-clickhouse é um servidor Model Context Protocol (MCP) que conecta assistentes de IA, como o Claude Desktop, a um banco de dados ClickHouse. Ele disponibiliza ferramentas para listar bancos de dados, percorrer tabelas em páginas e executar consultas SQL, permitindo que um assistente explore um schema e responda a perguntas analíticas com dados em tempo real.

As consultas são executadas em modo somente leitura por padrão. É preciso habilitar gravações explicitamente com CLICKHOUSE_ALLOW_WRITE_ACCESS, e instruções destrutivas, como DROP, TRUNCATE, DELETE e UPDATE, exigem uma segunda opção de habilitação. O projeto também inclui um backend chDB opcional para consultar arquivos e fontes locais pelo mecanismo integrado do ClickHouse, além de oferecer suporte aos transportes stdio e HTTP/SSE com autenticação por bearer token ou OAuth/OIDC.

O servidor é escrito em Python e instalado pelo PyPI, normalmente iniciado por meio do uv. Ele também oferece um endpoint /health para implantações HTTP.

Recursos principais

  • 01Executa consultas SQL em um cluster ClickHouse e retorna resultados em JSON.
  • 02Lista bancos de dados e percorre tabelas em páginas com filtros LIKE.
  • 03Somente leitura por padrão, com opções de habilitação separadas para gravações e operações destrutivas.
  • 04Consultas parametrizadas usando placeholders {name:Type} do ClickHouse.
  • 05Backend chDB opcional para consultar arquivos e fontes sem ETL.
  • 06Oferece suporte aos transportes stdio, HTTP e SSE com autenticação por bearer token ou OAuth/OIDC.

Casos de uso

  • Permitir que um assistente de IA explore schemas de tabelas e responda a perguntas sobre dados do ClickHouse.
  • Oferecer aos analistas uma interface conversacional para consultar dados analíticos somente leitura.
  • Consultar arquivos locais ou fontes remotas pelo mecanismo integrado chDB usando um assistente.

Início rápido

  1. 1

    Instale o pacote do PyPI com o extra opcional chDB

    pip install 'mcp-clickhouse[chdb]'
  2. 2

    Configure a conexão com o ClickHouse e inicie o servidor conforme descrito no README

Antes de usar

  • É necessário configurar a autenticação antes da inicialização para que os transportes HTTP e SSE funcionem.

Tópicos

#mcp#clickhouse#sql#ai-agent#database#llm-tools#python

Perguntas frequentes

O que é mcp-clickhouse?
Servidor MCP que permite a assistentes de IA executar consultas SQL e explorar schemas no ClickHouse, com modo somente leitura ativado por padrão. mcp-clickhouse é um servidor Model Context Protocol (MCP) que conecta assistentes de IA, como o Claude Desktop, a um banco de dados ClickHouse. Ele disponibiliza ferramentas para listar bancos de dados, percorrer tabelas em páginas e executar consultas SQL, permitindo que um assistente explore um schema e responda a perguntas analíticas com dados em tempo real.
mcp-clickhouse é gratuito? Qual é a licença?
mcp-clickhouse é open source sob a licença Apache-2.0. Confira os termos da licença antes de usá-lo em produtos comerciais.
mcp-clickhouse ainda é mantido?
Manutenção ativa. O último commit de mcp-clickhouse foi em 21 de out. de 2026.
Para que posso usar mcp-clickhouse?
Permitir que um assistente de IA explore schemas de tabelas e responda a perguntas sobre dados do ClickHouse. Oferecer aos analistas uma interface conversacional para consultar dados analíticos somente leitura. Consultar arquivos locais ou fontes remotas pelo mecanismo integrado chDB usando um assistente.
Como instalar mcp-clickhouse?
Instale o pacote do PyPI com o extra opcional chDB: pip install 'mcp-clickhouse[chdb]' Configure a conexão com o ClickHouse e inicie o servidor conforme descrito no README
Onde consigo mcp-clickhouse?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/ClickHouse/mcp-clickhouse

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados