ClickHouse 官方 MCP 服务器：让 AI 直接查分析型数据库出报表
mcp-clickhouse 是 ClickHouse 官方组织在 GitHub 开源的 MCP 服务器，Apache 2.0 协议，持续更新中，安装包发布在 PyPI。ClickHouse 本身是面向实时分析的列式数据库，日志、行为、监控这类海量数据进去，聚合查询秒级出结果；这个服务器把查询能力接进 AI 客户端——你用自然语言问，它转成 SQL 在你的集群上跑，结果原样带回来。新版本协议与旧版握手都支持，新老客户端都能连。
核心功能与特点
- 三个核心工具：跑查询、列数据库、列表格——覆盖问答与探索两类高频动作，表格列表支持分页与名称过滤
- 默认只读：查询默认在只读模式运行，写操作要显式开启开关才放行，AI 误操作改不动生产数据
- 参数化查询：值与语句分离传入，按类型占位绑定，避免手拼字符串带来的注入风险
- 跑前体检：支持先描述结果列结构、先估算要读多少行再执行——扫全表的贵查询在执行前就能拦下来看一眼
- 嵌入式引擎可选：装上可选组件后，能在本机直接查文件与数据源，不用先建集群，轻量分析场景很顺手
- 健康检查端点：HTTP 部署自带健康探针，负载均衡与容器编排可以直接拿来做存活检测
- 大整数不丢精度：超出前端安全范围的整数以字符串返回，金额、ID 类数据不会悄悄变毛
怎么获取
在 GitHub 搜索组织 ClickHouse 名下的 mcp-clickhouse 仓库，按 README 配置；PyPI 上按包名安装，填好集群地址与账号即可启用。写权限、传输方式等细节以官方文档为准。
上手用法
- 日志问答：「过去一周哪个接口报错多，按天列出来」——AI 出 SQL、集群跑聚合，答完直接贴数
- 报表口径探索：先让 AI 描述这版查询会返回哪些列，确认口径再执行，报表少返工
- 贵查询拦截：跑之前先估算读取量，看到要扫上亿行就让 AI 换个带索引条件的写法
- 本机小分析：用嵌入式引擎直接查导出的日志文件，临时取数不惊动线上库
- 监控大盘取数：把常用指标查询交给 AI 客户端按需取，周报数字随问随得
适合谁用
有海量日志、行为或监控数据要分析的团队：SaaS 公司看活跃、电商看漏斗、IT 运维看设备日志趋势。贵州诚鑫致达科技帮客户做网络与服务器维护，深知监控数据攒得快、查得慢有多难受——把只读查询交给 AI 客户端，同事要数不用排队等报表。如果你家的数据也在分析库里睡着，可以按这个思路搭一条问答通道。
企业存储选型参考｜贵州诚鑫致达
做全闪高性能数据库与虚拟化，群晖机型参考：FS6400 · FS3410 · FS2500。需要选型建议或上门评估，搜「诚鑫致达」即可找到我们。