ClickHouse 只读 MCP
一个用于执行只读 ClickHouse 查询的 FastMCP 服务器，支持本地 Python API 集成和作为独立服务运行。
功能特点
- 支持通过 MCP 工具执行只读 SQL 查询
- 输入验证确保只能执行
SELECT、SHOW、DESCRIBE、EXPLAIN等只读操作
- 支持 HTTP 和原生 ClickHouse 连接方式，自动故障切换
- 简洁的表格格式输出结果
- 支持参数化查询
- 高性能查询执行和结果处理
安装
通过 pip 安装
从源码安装
使用方法
以
cursor 为例，将如下字典放入 config.json：
其中 sys.executable 为 Python 虚拟环境的执行文件，通常名字为 python，conda 或 uv 下皆可以。
clickhouse_mcp_py 为 main.py 的绝对路径。请注意：
CLICKHOUSE_PORT为原生连接的端口，CLICKHOUSE_HTTP_PORT为 HTTP 协议端口，该 MCP 会自动切换，不一定需要全部填写；
CLICKHOUSE_RESOURCE_DESC_FILE是一个说明文件，可以将数据库中的一些信息放入其中，例如表的功能描述，能够提升模型理解能力；
CLICKHOUSE_ENABLED默认可以不用填写。
许可证
MIT
- Author:waytomcp
- URL:https://www.waytomcp.com/article/the-nine-nation/clickhouse-mcp
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
