ClickHouse MCP Server
2025.03.20
6
Python数据库服务AI 数据库接口数据库
ClickHouse MCP Server 是一个为 ClickHouse 数据库实现的模型上下文协议（MCP）服务器。它提供了一个安全且结构化的方式，让 AI 助手能够探索和分析数据库。通过受控的接口，AI 助手可以列出表、读取数据并执行 SQL 查询，确保对数据库的负责任访问。
View on GitHub
Overview
基本能力
产品定位
ClickHouse MCP Server 是一个为 ClickHouse 数据库设计的 MCP 服务器，旨在通过 AI 助手提供数据库的探索和分析能力。
核心功能
- 提供安全的数据库访问接口
- 支持列出数据库表
- 支持读取数据
- 支持执行 SQL 查询
适用场景
- AI 助手需要访问和分析 ClickHouse 数据库的场景
- 需要结构化方式探索数据库的场景
- 需要安全控制数据库访问的场景
工具列表
uv包管理器：用于运行和管理 MCP 服务器- ClickHouse 数据库：作为后端数据库
常见问题解答
- 如何配置数据库连接？通过环境变量或命令行参数配置。
- 如何运行 MCP 服务器？使用
uv包管理器运行。
使用教程
使用依赖
- 安装 Python 和
uv包管理器 - 安装 ClickHouse 数据库
- 安装 MCP 服务器依赖
安装教程
- 配置环境变量或命令行参数：
bash CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT=8123 CLICKHOUSE_USER=default CLICKHOUSE_PASSWORD=CHANGE_TO_YOUR_PASSWORD CLICKHOUSE_DATABASE=default - 使用
uv运行 MCP 服务器：bash uv --directory /path/to/clickhouse_mcp_server run -m clickhouse_mcp_server.server
调试方式
- 检查环境变量或命令行参数是否正确配置
- 确保 ClickHouse 数据库正常运行
- 检查 MCP 服务器日志以获取错误信息