mcp-clickhouse

🚀 ClickHouse MCP 服务器

ClickHouse MCP 服务器是一个专为 ClickHouse 设计的服务器，可帮助用户在 ClickHouse 集群上执行各类操作，如 SQL 查询、数据库和表的列举等。

✨ 主要特性

工具

• run_select_query
  • 功能：在你的 ClickHouse 集群上执行 SQL 查询。
  • 输入：sql（字符串），即要执行的 SQL 查询。
  • 安全性：所有 ClickHouse 查询都会以 readonly = 1 运行，以确保它们是安全的。
• list_databases
  • 功能：列出你的 ClickHouse 集群上的所有数据库。
  • 输入：无。
  • 输出：数据库列表。
• list_tables
  • 功能：列出指定数据库中的所有表。
  • 输入：database（字符串），即要列出表的数据库名称。
  • 输出：表格列表。

📦 安装指南

要在你的项目中使用这个 MCP 服务器，你需要在 pyproject.toml 或 setup.py 中添加以下配置：

[project.urls]
Homepage = "https://glama.ai/mcp/servers/yvjy4csvo1"

🔧 技术细节

环境变量

你可以通过环境变量来配置 MCP 服务器的行为。以下是支持的环境变量及其作用： | 变量名 | 作用 | |--------|------| | CLICKHOUSE_HOST | 设置 ClickHouse 服务器的主机名或 IP 地址。 | | CLICKHOUSE_PORT | 设置 ClickHouse 服务器的端口（默认为 8123）。 | | CLICKHOUSE_USER | 设置连接 ClickHouse 的用户名。 | | CLICKHOUSE_PASSWORD | 设置连接 ClickHouse 的用户密码。 | | CLICKHOUSE_DATABASE | 设置要使用的数据库名称（可选，默认为 default）。 |

示例配置

本地开发

# 必需变量
CLICKHOUSE_HOST=localhost
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=clickhouse

# 可选变量：覆盖默认值
CLICKHOUSE_SECURE=false  # 使用端口 8123 自动
CLICKHOUSE_VERIFY=false

ClickHouse Cloud

# 必需变量
CLICKHOUSE_HOST=your-instance.clickhouse.cloud
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=your-password

# 可选变量：使用安全默认值
# CLICKHOUSE_SECURE=true  # 使用端口 8443 自动
# CLICKHOUSE_DATABASE=your_database

ClickHouse SQL Playground

CLICKHOUSE_HOST=sql-clickhouse.clickhouse.com
CLICKHOUSE_USER=demo
CLICKHOUSE_PASSWORD=
# 使用安全默认值（HTTPS 在端口 8443）

📚 详细文档

YouTube 总结