ClickHouse MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Allows querying and interacting with ClickHouse databases, providing tools for executing SQL select queries, listing databases, and viewing tables within a database.

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 (字符串):数据库的名称。

配置

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

  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>
  1. 运行fastmcp install mcp_clickhouse/mcp_server.py -f .env.production来安装服务器。
  2. 重新启动 Claude Desktop。

发展

  1. test-services目录中运行docker compose up -d来启动 ClickHouse 集群。
  2. 将以下变量添加到存储库根目录中的.env文件中。
CLICKHOUSE_HOST=localhost CLICKHOUSE_PORT=8123 CLICKHOUSE_USER=default CLICKHOUSE_PASSWORD=clickhouse
  1. 运行uv sync来安装依赖项。要安装uv ,请按照此处的说明操作。然后执行source .venv/bin/activate
  2. 为了方便测试,您可以运行fastmcp dev mcp_clickhouse/mcp_server.py来启动 MCP 服务器。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

ClickHouse 的 MCP 服务器。

  1. Migrated to https://github.com/ClickHouse/mcp-clickhouse
    1. Features
    2. Configuration
    3. Development
ID: 9292900sx1