ClickHouse查询服务

ClickHouse MCP服务器

迁移到https://github.com/ClickHouse/mcp-clickhouse

ClickHouse的MCP服务器。

特性

工具

• run_select_query

  • 在ClickHouse集群上执行SQL查询。
  • 输入： sql （string）：要执行的SQL查询。
  • 所有ClickHouse查询都使用 readonly = 1 以确保它们的安全。

• list_databases

  • 列出ClickHouse集群上的所有数据库。

• list_tables

  • 列出数据库中的所有表。
  • 输入： database （string）：数据库的名称。

配置

备注：这是一个临时配置过程，一旦包发布，它将得到显著改进。

1. 跑 uv sync 安装依赖项。安装 uv 按照说明 这里。那就去吧 source .venv/bin/activate.

2. 设置 .env.production 使用ClickHouse凭据创建文件。

CLICKHOUSE_HOST=<CLICKHOUSE_HOST>
CLICKHOUSE_PORT=<CLICKHOUSE_PORT>
CLICKHOUSE_USER=<CLICKHOUSE_USER>
CLICKHOUSE_PASSWORD=<CLICKHOUSE_PASSWORD>

3. 跑 fastmcp install mcp_clickhouse/mcp_server.py -f .env.production 安装服务器。

4. 重新启动克劳德桌面。

发展

1. 在……里面 test-services 目录运行 docker compose up -d 启动ClickHouse集群。

2. 将以下变量添加到 .env 存储库根目录中的文件。

CLICKHOUSE_HOST=localhost
CLICKHOUSE_PORT=8123
CLICKHOUSE_USER=default
CLICKHOUSE_PASSWORD=clickhouse

3. 跑 uv sync 安装依赖项。安装 uv 按照说明 这里。那就去吧 source .venv/bin/activate.

4. 为了便于测试，您可以运行 fastmcp dev mcp_clickhouse/mcp_server.py 启动MCP服务器。