从MCP客户端安全查询ClickHouse分析数据

要解决的问题

当 AI 助手需要直接读取 ClickHouse 的分析数据时，最常见的做法是把数据库地址、账号和密码交给模型，让它自行构造 SQL 执行。这种做法问题不少：凭证范围不受控、模型可能写出有副作用的写入语句、每次查询都得人工复核，审计线索也很难沉淀下来。

核心能力

这个技能把访问方式换成 ClickHouse 官方 MCP 服务器，让助手通过一组有边界的工具做 schema 感知的查询：

• 只读默认：查询默认以只读模式运行（CLICKHOUSE_ALLOW_WRITE_ACCESS=false），写入能力只在明确需要时才开启
• 传输层认证：HTTP 与 SSE 传输默认强制认证；默认的 stdio 传输只通过标准输入输出通信，不涉及网络鉴权
• 可选 chdb 依赖：需要额外安装 mcp-clickhouse[chdb] 这个 extra

关键步骤是：准备 Python 运行环境与 mcp-clickhouse 包、配置 ClickHouse 凭证、在 MCP 客户端里接入，之后模型即可在受控的工具范围内完成探索性分析。官方文档还提供了 Azure Entra 等认证示例。

适用边界

它解决的是分析型、可审查的数据访问，不是通用数据库管理通道。启动服务需要本地 Docker 环境，依赖安装和 linting 也要按上游流程走。如果你的场景需要临时提权、跨库写操作或脱离工具集直接执行任意 SQL，这个方案并不合适。