Repolode
ClickHouse

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. 1

    从 PyPI 安装该包(含可选的 chDB 扩展)

    pip install 'mcp-clickhouse[chdb]'
  2. 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 数据每日更新。

相关项目