ClickHouse

官方 ClickHouse 数据与数据库

让智能体在 ClickHouse 中执行 SQL、查看数据库和表,并通过 chDB 查询外部数据。 摘要由 AI Index 撰写。

Registry 描述:Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB.

本地安装包(pypi) 需要填写:CLICKHOUSE_HOST, CLICKHOUSE_USER

添加到你的客户端

把 ClickHouse MCP 服务器添加到 Claude Code

  1. 运行命令

    claude mcp add -e CLICKHOUSE_HOST=<CLICKHOUSE_HOST> -e CLICKHOUSE_USER=<CLICKHOUSE_USER> clickhouse -- uvx mcp-clickhouse
  2. 填写取值 ↓

  3. 确认已连接

如果文件里已有其他服务器,把这一项加到已有的对象里。 确认是否已连接:重启或重新加载客户端,在它的 MCP 服务器列表里找到 clickhouse。需要登录的服务器会在第一次使用时打开登录。

需要填写的值

必填项以 <NAME> 占位符出现在片段里;可选项按同样方式添加。说明来自服务器在 Registry 里的条目。

  • <CLICKHOUSE_HOST> 环境变量 必填

    Hostname of the ClickHouse server

  • <CLICKHOUSE_USER> 环境变量 必填

    Username for ClickHouse authentication

  • <CLICKHOUSE_PASSWORD> 环境变量 可选 · 密钥

    Password for ClickHouse authentication. Required unless a client certificate uses the default or mutual TLS mode

  • <CLICKHOUSE_PORT> 环境变量 可选

    ClickHouse HTTP(S) port. Defaults to 8443 when CLICKHOUSE_SECURE=true, 8123 otherwise

  • <CLICKHOUSE_SECURE> 环境变量 可选

    Use HTTPS to connect to ClickHouse

  • <CLICKHOUSE_VERIFY> 环境变量 可选

    Verify SSL certificates

  • <CLICKHOUSE_CA_CERT> 环境变量 可选

    Path to a PEM CA bundle for ClickHouse server certificate verification

  • <CLICKHOUSE_CLIENT_CERT> 环境变量 可选

    Path to a PEM client certificate for the ClickHouse HTTPS connection

  • <CLICKHOUSE_CLIENT_CERT_KEY> 环境变量 可选

    Path to the PEM private key for CLICKHOUSE_CLIENT_CERT

  • <CLICKHOUSE_TLS_MODE> 环境变量 可选

    Client certificate mode: mutual, proxy, or strict

  • <CLICKHOUSE_DATABASE> 环境变量 可选

    Default database to use

  • <CLICKHOUSE_ROLE> 环境变量 可选

    ClickHouse role to activate for the session

  • <CLICKHOUSE_ALLOW_WRITE_ACCESS> 环境变量 可选

    Allow write operations (DDL and DML). Queries run read-only by default

  • <CLICKHOUSE_ALLOW_DROP> 环境变量 可选

    Allow destructive operations (DROP, TRUNCATE, DELETE, UPDATE, REPLACE, CLEAR, and DETACH PERMANENTLY) when write access is also enabled

  • <CLICKHOUSE_MCP_QUERY_TIMEOUT> 环境变量 可选

    Query tool timeout in seconds

  • <CLICKHOUSE_MCP_MAX_WORKERS> 环境变量 可选

    Maximum query worker thread pool size

客户端兼容性

按传输方式判断:客户端文档列出的传输方式里是否有这个服务器提供的。不涉及登录等其他要求。

Agent Skills: ClickHouse

clickhouse-architecture-advisor、clickhouse-best-practices、chdb-datastore、chdb-sql、clickstack-otel-collector、ClickHouse、infra-clickhouse、infra-postgres、clickhouse-js-node-troubleshooting、clickhouse

来源

This data comes from the Official MCP Registry.