ChMonitor

社区

ClickHouse 的 AI 运维顾问与 MCP 服务器

分类: 数据库第 13 / 58
Stars: ★ 301 非常热门
传输方式: Streamable HTTP
运行环境: 远程托管（无需本地环境） · Docker
凭据: 需要 API Key / 凭据
许可证: GPL-3.0
最近提交: 今天

64FMRS · C

chmonitor 是一个针对 ClickHouse 的 MCP 服务器，提供只读监控和 AI 建议，适合需要将 ClickHouse 接入 AI 工具的团队。它支持多种部署方式，具有活跃的社区和文档，但注意它是推荐而非自动执行，需要用户自行评估应用。

最强项 · 维护活跃度 15/20 最弱项 · 可靠性 7/20

可靠性

7/20

安全与权限

14/20

维护活跃度

15/20

文档质量

14/20

安装易用性

14/20

查看各项评分依据

可靠性 7/20: 清单和 README 描述了合理的 streamable-http MCP 端点（/api/mcp），并给出 Claude Code / Claude Desktop / Cursor 的客户端配置示例，声明只读访问 schema、查询、合并、复制与集群健康。但本次审查未获得 apps/mcp 的源码、测试或 CI 定义，无法验证 init/工具列表握手、声明的工具集是否与真实行为一致，以及错误处理是否可控。README 与清单属于不可信证据，证据缺失即扣分；happy path 仅存在可能性，因此低于 10 分锚点。评分 7。
安全与权限 14/20: 设计层面明确为仅建议/只读（“从不自动应用 DDL”），托管远端要求机密的 Authorization 头（chm_ API key 或 Clerk OAuth），文档中提供最小权限只读 ClickHouse 连接预设，遥测默认关闭且为可选，安装示例仅使用占位符（chm_your_api_key、change-me），未含真实令牌，未触发任何红线。扣分点：代码级强制措施（只读会话标志、查询超时、语句过滤、限流、令牌作用域与轮换）无法从现有材料验证；“只读”仅是 README/清单的自述，且自托管默认无认证，若公网暴露存在风险。评分 14。
维护活跃度 15/20: 项目未归档，具有明确的 GPL-3.0 许可证，README 描述了由 GitHub Actions 从 v* 标签构建的发布流水线（Docker 镜像、Node 独立包、Cloudflare Workers 包、校验和）及 Build-and-Test CI 徽章，v0.3 迁移文档表明项目处于持续演进中，开放 issue 数较少。扣分点：未提及安全响应渠道（如 SECURITY.md），无依赖更新（Dependabot/Renovate）证据，提交频率与 issue 响应速度无法从 README/清单验证；MCP 清单版本 0.2.9 落后于应用 v0.3，说明 MCP 组件版本管理独立且存在滞后。评分 15。
文档质量 14/20: 文档分层完善：README 提供快速开始、Docker/Cloudflare Workers 部署指南、MCP 客户端接入命令与 JSON 配置示例、认证说明（API key/OAuth）、最小权限连接预设、支持矩阵、价格与版本对比表、遥测披露、升级迁移指南，并声明存在 llms.txt 与 docs/knowledge 文档。扣分点：server manifest 未附带任何工具清单（tools 字段）或逐工具参数与限制说明；MCP 专属文档（mcp-clients.mdx、docs/knowledge/mcp-server.md）和故障排查内容仅被引用而未被提供，质量无法核实。评分 14。
安装易用性 14/20: 安装路径简短：一条带 CLICKHOUSE_HOST/USER/PASSWORD 的 Docker 命令即可启动，或直接注册托管版；随后有现成的 Claude Code 一行命令、Claude Desktop/Cursor JSON 配置示例（含 Authorization 头），自托管可省略认证头。平台覆盖面广（Docker、Kubernetes/Helm、Cloudflare Workers、Railway/Render/Fly 一键模板）。扣分点：受静态校准约束，未提供服务端 CI/测试等可验证执行证据，因此 setup 上限为 15；用户需将清单中的托管 URL 替换为自身部署地址，API key 的创建步骤仅被引用而未展示。评分 14。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络连接数据库

适合谁

希望获得 ClickHouse 实时监控和 AI 驱动优化建议的团队
需要将 ClickHouse 数据接入 AI 助手的开发者和数据工程师
使用 Docker、Kubernetes 或 ClickHouse Cloud 部署的用户

不适合谁

不需要 ClickHouse 监控或优化建议的用户
寻求自动执行 schema 修改或 DDL 操作的用户（chmonitor 仅推荐，不执行）
需要写入或修改 ClickHouse 数据的场景

所需权限

只读访问 ClickHouse system.* 表（schema、查询、合并、复制等）
需要 ClickHouse 用户具有 system 表读取权限（如 default 或专门只读用户）
对托管实例需要有效的 API 密钥

风险与副作用

只读操作，但需确保 API 密钥安全，避免泄露导致未授权访问
AI 推荐可能不准确，请人工审查后再应用
自托管时需保护 ClickHouse 凭据（CLICKHOUSE_PASSWORD）

安装接入

准备工作

运行环境：远程托管（无需本地环境） · Docker

CLICKHOUSE_HOST 必填 ClickHouse 服务地址（如 https://host:8443），自部署时必填；连接托管端点时无需设置。

CLICKHOUSE_USER 必填 ClickHouse 用户名，建议使用文档中的只读最小权限用户。

CLICKHOUSE_PASSWORD 必填密钥上述 ClickHouse 用户的密码。

CHM_API_KEY_SECRET 可选密钥可选，用于保护自部署实例 /api/v1/* 路由的签名密钥。

CLERK_SECRET_KEY 可选密钥 Clerk 私钥，启用 Clerk 认证时需要。

CLOUDFLARE_API_TOKEN 可选密钥部署到 Cloudflare Workers 时所需的 API 令牌，仅部署者需要。

其他可选配置项（7 个）

CLICKHOUSE_TZ 可选可选时区设置，例如 UTC。

CHM_AUTH_PROVIDER 可选服务端认证方式：none、clerk 或 proxy，默认 none。

VITE_AUTH_PROVIDER 可选客户端认证方式（构建时内联），旧名 NEXT_PUBLIC_AUTH_PROVIDER 仍可用作回退。

VITE_CLERK_PUBLISHABLE_KEY 可选 Clerk 公钥（构建时内联），启用 Clerk 登录时需要。

CHM_CONFIG_FILE 可选可选，指向 config.toml 配置文件路径，用于功能开关与访问控制。

CHM_FEATURE_AGENT_ACCESS 可选可选，env 方式设置 AI Agent 功能的访问级别（如 authenticated）。

CHM_DISABLED_FEATURES 可选可选，逗号分隔的需要禁用的功能列表（如 settings,metrics）。

确保你有 ClickHouse 集群和一个 chm_ API 密钥（通过仪表板 操作/认证/API 密钥 创建）。
在 MCP 客户端（如 Claude Desktop、Claude Code、Cursor）中，将服务器 URL 配置为 https://dash.chmonitor.dev/api/mcp，并在请求头中添加 Authorization: Bearer chm_YOUR_API_KEY。
或者，自托管实例可在无认证的情况下运行，省略 Authorization 头。

claude_desktop_config.json

{
  "mcpServers": {
    "chmonitor": {
      "url": "https://dash.chmonitor.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer chm_YOUR_API_KEY"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "chmonitor": {
      "url": "https://dash.chmonitor.dev/api/mcp",
      "headers": {
        "Authorization": "Bearer chm_YOUR_API_KEY"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add --transport http chmonitor https://dash.chmonitor.dev/api/mcp --header 'Authorization: Bearer chm_YOUR_API_KEY'

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端添加该 MCP 服务器后，工具列表应出现 chmonitor 提供的只读 ClickHouse 工具；可以提问"我有哪些数据库和表？"，如果能返回真实 schema 即连接成功。

常见排障

检查 API 密钥是否有效，且未被吊销
确认 ClickHouse 实例可访问，且网络防火墙未阻止连接
在自托管实例中，确认已配置正确的 CLICKHOUSE_* 环境变量
查看 MCP 服务器日志，确认认证和连接错误

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出当前正在运行的 ClickHouse 查询及其资源占用情况
根据 system.* 表给出我的表应该添加哪些跳数索引和物化视图的建议
查看复制队列的状态，告诉我有没有堆积的副本任务
解释一下最近最慢的那条查询的 EXPLAIN 计划

使用场景

监控 ClickHouse 集群健康、查询、合并和复制状态

通过 AI 助手获取 schema 和性能优化建议（只读，不会自动执行 DDL）

将 ClickHouse 接入 Claude、Cursor 等 AI 工具，进行自然语言查询和分析

支持客户端

Claude Desktop

Claude Code

Cursor

依据项目文档列出，未经本站实测。

详细介绍

chmonitor 是一个开源的 ClickHouse 运维顾问，提供实时监控和基于 AI 的索引、分区、物化视图推荐。它作为只读 MCP 服务器，通过 HTTP 流式传输暴露 schema、查询、合并、复制和集群健康信息，支持自托管和云服务。

ChMonitor

选型与风险

适合谁

不适合谁

所需权限

风险与副作用

安装接入

准备工作

验证是否装好

常见排障

试试这样问

使用场景

支持客户端

详细介绍

同类可选方案