支持多种数据库的 AI 数据库客户端,同时提供 MCP 服务器供智能体查询。
ClickHouse/mcp-clickhouse
让 AI 助手通过 MCP 协议查询 ClickHouse 并浏览库表结构的服务器,默认只读。
- Star
- 890
- Fork
- 210
- 未关闭 Issue
- 8
- 最近提交
- 23小时前
这是什么?
mcp-clickhouse 是一个 Model Context Protocol(MCP)服务器,可将 Claude Desktop 等 AI 助手连接到 ClickHouse 数据库。它提供列出数据库、分页浏览表、执行 SQL 查询等工具,助手可以基于实时数据探索表结构并回答分析类问题。
默认情况下查询以只读模式运行。开启写入需要显式设置 CLICKHOUSE_ALLOW_WRITE_ACCESS,而 DROP、TRUNCATE、DELETE、UPDATE 等破坏性语句还需要额外的开关。项目还提供可选的 chDB 后端,可通过 ClickHouse 嵌入式引擎直接查询本地文件等数据源。传输方式支持 stdio 与 HTTP/SSE,认证支持静态 Bearer Token 以及 OAuth/OIDC。
服务器使用 Python 编写,可从 PyPI 安装,常通过 uv 启动。HTTP 部署时还提供 /health 健康检查接口。
核心功能
- 01对 ClickHouse 集群执行 SQL 查询并返回 JSON 结果。
- 02列出数据库,并按 LIKE 条件分页浏览表。
- 03默认只读,写入与破坏性操作需分别显式开启。
- 04支持使用 {name:Type} 占位符的参数化查询。
- 05可选 chDB 后端,无需 ETL 即可查询文件等数据源。
- 06支持 stdio、HTTP 与 SSE 传输,认证可选 Bearer Token 或 OAuth/OIDC。
适用场景
- 让 AI 助手浏览表结构,并基于 ClickHouse 数据回答问题。
- 为分析人员提供对只读分析数据的对话式访问入口。
- 通过嵌入式 chDB 引擎,让助手直接查询本地文件或远程数据源。
快速上手
- 1
从 PyPI 安装该包(含可选的 chDB 扩展)
pip install 'mcp-clickhouse[chdb]' - 2
按照 README 配置 ClickHouse 连接并启动服务器
使用前须知
- 使用 HTTP 或 SSE 传输时,必须先配置身份验证,否则服务器无法启动。
标签
常见问题
- mcp-clickhouse 是什么?
- 让 AI 助手通过 MCP 协议查询 ClickHouse 并浏览库表结构的服务器,默认只读。 mcp-clickhouse 是一个 Model Context Protocol(MCP)服务器,可将 Claude Desktop 等 AI 助手连接到 ClickHouse 数据库。它提供列出数据库、分页浏览表、执行 SQL 查询等工具,助手可以基于实时数据探索表结构并回答分析类问题。
- mcp-clickhouse 可以免费使用吗?用的什么许可证?
- mcp-clickhouse 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
- mcp-clickhouse 还在维护吗?
- 活跃维护中。mcp-clickhouse 最近一次提交是在 2026年10月21日。
- mcp-clickhouse 适合用来做什么?
- 让 AI 助手浏览表结构,并基于 ClickHouse 数据回答问题。 为分析人员提供对只读分析数据的对话式访问入口。 通过嵌入式 chDB 引擎,让助手直接查询本地文件或远程数据源。
- mcp-clickhouse 怎么安装和运行?
- 从 PyPI 安装该包(含可选的 chDB 扩展): pip install 'mcp-clickhouse[chdb]' 按照 README 配置 ClickHouse 连接并启动服务器
- 在哪里获取 mcp-clickhouse?
- 源代码和安装说明在 GitHub 上:https://github.com/ClickHouse/mcp-clickhouse
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
让 AI 智能体通过 MCP 协议查询和管理 MongoDB 数据库与 Atlas 集群的服务器。
免费、本地优先的 AI 辅助数据库客户端与 SQL 工作台,支持 40 多种数据库。
开源 MCP 服务器,让 AI 智能体、IDE 和应用安全连接各类数据库。
一个精简、节省 token 的 MCP 服务器,让 AI 客户端查询和探索 PostgreSQL、MySQL 等多种数据库。
让 Claude 等大模型通过 MCP 协议以只读方式访问 MySQL 数据库,可按需开启写操作。