mcp-clickhousemcp-clickhouse MCP 服务

— (0)

审阅者 Daniel Nikulshyn·更新 2026年6月

概览

mcp-clickhouse MCP 服务是ClickHouse的MCP 服务。它包含ClickHouse的相关工具，包括 run_query 执行 ClickHouse 集群上的 SQL 查询、list_databases列出ClickHouse集群中的所有数据库、和 list_tables 列表包含分页的数据库表，以及 chDB 工具，如 run_chdb_select_query执行 SQL 查询使用 chDB 的内嵌 ClickHouse 引擎。还提供一个健康检查端点来检查服务器的健康状况以及安全机制来进行身份验证。该服务器可以设置为内部服务、局部开发或通过FastMCP与OAuth / OIDC身份验证提供商配合使用。

主要功能

run_query 执行 ClickHouse 集群上的 SQL 查询
list_databases 列出 ClickHouse集群中的所有数据库
list_tables 列表包含分页的数据库表
run_chdb_select_query 执行 SQL 查询使用 chDB 的内嵌 ClickHouse 引擎
健康检查端点用于服务器监控
支持多个身份验证模式，包括OAuth与OIDC通过FastMCP

价格

模型: Free
分类: 服务配缩器
评分: 暂无评价

使用场景

监视ClickHouse 服务健康状况

使用健康检查端点监视服务器健康状况并检测任何问题。

在ClickHouse 集群上执行 SQL 查询

使用ClickHouse工具，例如run_query，来在ClickHouse集群上执行SQL查询。

ClickHouse 服务加密

通过支持的多种身份验证模式，使用FastMCP中的OAuth和OIDC来实现身份验证和授权。

优点 & 缺点

优点

支持在ClickHouse集群上执行SQL查询
支持多个身份验证模式，包括OAuth与OIDC
集成了内嵌健康检查端点用于服务器监控

缺点

仅适合用于内部服务因安全考量
执行SQL查询时有一定的灵活性限制
需要正确配置身份验证和授权

对决战绩

在万神殿中参与了 1 对决。

第1

第2

第3

Last battle

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

评测

登录以留下评测。

暂无评测。来当第一个吧!

问答

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