mcp-clickhouseServidor mcp-clickhouse MCP

— (0)

Avaliado por Daniel Nikulshyn·Atualizado junho de 2026

Visão geral

O servidor mcp-clickhouse MCP é um servidor MCP para ClickHouse. Ele inclui Ferramentas ClickHouse, como run_query para executar consultas SQL em seu cluster ClickHouse, list_databases para listar todos os bancos de dados em seu cluster ClickHouse e list_tables para listar tabelas em um banco de dados com paginação. Além disso, inclui Ferramentas chDB, como run_chdb_select_query, para executar consultas SQL usando o mecanismo ClickHouse incorporado do chDB. Ele também fornece um Endpoint de Verificação de Saúde para verificar a saúde do servidor e um mecanismo de segurança para autenticação. O servidor pode ser configurado para serviços internos, desenvolvimento local ou com provedores de autenticação OAuth / OIDC por meio do FastMCP.

Funcionalidades principais

run_query para executar consultas SQL no cluster ClickHouse
list_databases para listar todos os bancos de dados no cluster ClickHouse
list_tables para listar tabelas em um banco de dados com paginação
run_chdb_select_query para executar consultas SQL usando o mecanismo ClickHouse incorporado do chDB
Endpoint de Verificação de Saúde para monitoramento do servidor
Múltiplos modos de autenticação, incluindo OAuth e OIDC por meio do FastMCP

Preços

Modelo: Free
Categoria: Servidores MCP
Avaliação: Ainda sem avaliações

Casos de uso

Monitorando a Saúde do Servidor ClickHouse

Use o Endpoint de Verificação de Saúde para monitorar a saúde do servidor e detectar quaisquer problemas.

Executando Consultas SQL no ClickHouse

Use as Ferramentas ClickHouse, como run_query, para executar consultas SQL em seu cluster ClickHouse.

Protegendo o Servidor ClickHouse

Implemente autenticação e autorização usando os múltiplos modos suportados, incluindo OAuth e OIDC por meio do FastMCP.

Prós e contras

Prós

Permite a execução de consultas SQL em um cluster ClickHouse
Suporta múltiplos modos de autenticação, incluindo OAuth e OIDC
Tem um endpoint de verificação de saúde incorporado para monitoramento do servidor

Contras

Apenas adequado para serviços internos devido a preocupações de segurança
Flexibilidade limitada na execução de consultas
Requer configuração adequada de autenticação e autorização

Histórico de batalhas

Em 1 batalha no Panteão.

1.º

2.º

3.º

Last battle

#3
MCP Servers Showdown — May 26, 2026
May 26, 2026 · #3 of 5

Avaliações

Entra para deixar uma avaliação.

Ainda sem avaliações. Sê o primeiro!

Perguntas e respostas

Can mcp-clickhouse execute write queries on the ClickHouse cluster?

Queries run in read‑only mode by default (`CLICKHOUSE_ALLOW_WRITE_ACCESS=false`). Write access can be enabled explicitly if needed, allowing `run_query` to execute INSERT or UPDATE statements when the server is configured to permit writes.

Asked by Celia Ramirez · Aug 6, 2025

What pagination options are available when listing tables in a database?

The `list_tables` tool supports pagination via `page_token` and `page_size` parameters. By default it returns 50 tables per page, but you can adjust `page_size` and use the returned `next_page_token` to fetch subsequent pages, optionally filtering with `like` or `not_like`.

Asked by Marisol Pena · Jul 31, 2025

How can I monitor the health of the mcp-clickhouse server in a Kubernetes environment?

The server exposes an unauthenticated health check endpoint at `/health` that returns `200 OK` with body `OK` when it can connect to ClickHouse, and `503 Service Unavailable` otherwise. This endpoint is designed for liveness/readiness probes in Kubernetes or load balancer checks.

Asked by Kwame Mensah · Jul 8, 2025

What authentication methods does mcp-clickhouse support and how are they configured?

mcp-clickhouse supports multiple authentication modes, including OAuth and OIDC via FastMCP, as well as internal service authentication. Configuration is done through the FastMCP settings in the server’s JSON configuration, allowing you to enable the desired provider and set required credentials.

Asked by Stella Papadopoulos · Jun 21, 2025