ClickHouse MCP 服务器

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

ClickHouse 的 MCP 服务器。

特征

工具

• run_select_query

  • 在您的 ClickHouse 集群上执行 SQL 查询。

  • 输入： sql （字符串）：要执行的 SQL 查询。

  • 所有 ClickHouse 查询均以readonly = 1运行，以确保它们是安全的。

• list_databases

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

• list_tables

  • 列出数据库中的所有表。

  • 输入： database （字符串）：数据库的名称。

Related MCP server: mcp-clickup

配置

注意：这是一个临时配置过程，一旦软件包发布，将会得到显著改善。

1. 运行uv sync来安装依赖项。要安装uv ，请按照此处的说明操作。然后执行source .venv/bin/activate 。

2. 使用 ClickHouse 凭证设置.env.production文件。

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. 重新启动 Claude Desktop。

发展

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 服务器。