适合谁
- 希望获得 ClickHouse 实时监控和 AI 驱动优化建议的团队
- 需要将 ClickHouse 数据接入 AI 助手的开发者和数据工程师
- 使用 Docker、Kubernetes 或 ClickHouse Cloud 部署的用户
C
64FMRS · C
chmonitor 是一个针对 ClickHouse 的 MCP 服务器，提供只读监控和 AI 建议，适合需要将 ClickHouse 接入 AI 工具的团队。它支持多种部署方式，具有活跃的社区和文档，但注意它是推荐而非自动执行，需要用户自行评估应用。
chmonitor 是一个开源的 ClickHouse 运维顾问，提供实时监控和基于 AI 的索引、分区、物化视图推荐。它作为只读 MCP 服务器，通过 HTTP 流式传输暴露 schema、查询、合并、复制和集群健康信息，支持自托管和云服务。
工具能力
暂未整理工具清单。
安装接入
- 确保你有 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"
}
}
}
}
选型与风险
不适合谁
- 不需要 ClickHouse 监控或优化建议的用户
- 寻求自动执行 schema 修改或 DDL 操作的用户（chmonitor 仅推荐，不执行）
- 需要写入或修改 ClickHouse 数据的场景
所需权限
- 只读访问 ClickHouse system.* 表（schema、查询、合并、复制等）
- 需要 ClickHouse 用户具有 system 表读取权限（如 default 或专门只读用户）
- 对托管实例需要有效的 API 密钥
风险与副作用
- 只读操作，但需确保 API 密钥安全，避免泄露导致未授权访问
- AI 推荐可能不准确，请人工审查后再应用
- 自托管时需保护 ClickHouse 凭据（CLICKHOUSE_PASSWORD）
常见排障
- 检查 API 密钥是否有效，且未被吊销
- 确认 ClickHouse 实例可访问，且网络防火墙未阻止连接
- 在自托管实例中，确认已配置正确的 CLICKHOUSE_* 环境变量
- 查看 MCP 服务器日志，确认认证和连接错误
使用场景
监控 ClickHouse 集群健康、查询、合并和复制状态
通过 AI 助手获取 schema 和性能优化建议（只读，不会自动执行 DDL）
将 ClickHouse 接入 Claude、Cursor 等 AI 工具，进行自然语言查询和分析
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Cursor完整支持