ClickHouse MCP Server
2025.04.07
1
TypeScript数据库连接自然语言查询数据分析数据库
ClickHouse MCP Server 是一个基于模型上下文协议（MCP）的服务，用于连接ClickHouse数据库，并通过自然语言查询让LLMs（如Claude）探索和分析数据。
View on GitHub
Overview
基本能力
产品定位
ClickHouse MCP Server 是一个数据库连接服务，允许通过自然语言查询访问和分析ClickHouse数据库中的数据。
核心功能
- 连接ClickHouse数据库
- 将表结构作为资源暴露
- 从自然语言指令运行SQL查询
- 执行只读SQL查询
- 与macOS上的Claude Desktop配合使用
适用场景
- 数据分析师通过自然语言查询数据库
- 开发人员快速探索数据库结构
- 与Claude Desktop集成进行数据交互
工具列表
execute-sql: 对数据库运行只读SQL查询natural-language-query: 用自然语言提问关于数据的问题
常见问题解答
- 安全性：服务器只允许只读SQL查询，敏感凭证应安全存储在环境变量中
- 验证：服务器执行基本验证以防止DDL或DML语句执行
使用教程
使用依赖
- 确保已安装Node.js环境
安装教程
- 克隆仓库
- 安装依赖:
npm install
- 在
.env文件中配置环境变量（参考.env.example） - 构建项目:
npm run build
调试方式
- 本地运行服务器:
npm start
- 与Claude Desktop集成:
- 更新Claude Desktop配置文件
- 添加服务器配置
- 重启Claude Desktop