ClickHouse
让智能体在 ClickHouse 中执行 SQL、查看数据库和表,并通过 chDB 查询外部数据。 摘要由 AI Index 撰写。
Registry 描述:Official ClickHouse MCP server for querying and exploring ClickHouse clusters and chDB.
CLICKHOUSE_HOST, CLICKHOUSE_USER 添加到你的客户端
把 ClickHouse MCP 服务器添加到 Claude Code
运行命令
claude mcp add -e CLICKHOUSE_HOST=<CLICKHOUSE_HOST> -e CLICKHOUSE_USER=<CLICKHOUSE_USER> clickhouse -- uvx mcp-clickhouse填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Cursor
打开 mcp.json· 文件位置:
~/.cursor/mcp.json,.cursor/mcp.json粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 VS Code
打开 mcp.json· 文件位置:
.vscode/mcp.json粘贴服务器配置
{ "servers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Codex
运行命令
codex mcp add clickhouse --env CLICKHOUSE_HOST=<CLICKHOUSE_HOST> --env CLICKHOUSE_USER=<CLICKHOUSE_USER> -- uvx mcp-clickhouse填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Devin Desktop
打开 mcp_config.json· 文件位置:
~/.config/devin/mcp_config.json,%APPDATA%\devin\mcp_config.json粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Gemini CLI
打开 settings.json· 文件位置:
~/.gemini/settings.json,.gemini/settings.json粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 GitHub Copilot
运行命令
copilot mcp add --env CLICKHOUSE_HOST=<CLICKHOUSE_HOST> --env CLICKHOUSE_USER=<CLICKHOUSE_USER> clickhouse -- uvx mcp-clickhouse填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Cline
打开 cline_mcp_settings.json· 文件位置:
~/.cline/data/settings/cline_mcp_settings.json粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Kiro
打开 mcp.json· 文件位置:
.kiro/settings/mcp.json,~/.kiro/settings/mcp.json粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 Zed
打开 settings.json
粘贴服务器配置
{ "context_servers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ], "env": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 OpenCode
打开 opencode.json· 文件位置:
~/.config/opencode/opencode.json,opencode.json粘贴服务器配置
{ "$schema": "https://opencode.ai/config.json", "mcp": { "clickhouse": { "type": "local", "command": [ "uvx", "mcp-clickhouse" ], "enabled": true, "environment": { "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>", "CLICKHOUSE_USER": "<CLICKHOUSE_USER>" } } } }填写取值 ↓
确认已连接
把 ClickHouse MCP 服务器添加到 JetBrains AI Assistant
打开 JetBrains AI Assistant 的 MCP 配置
- 打开 Settings | Tools | AI Assistant | Model Context Protocol (MCP)。
- 选择 Add。
粘贴服务器配置
{ "mcpServers": { "clickhouse": { "command": "uvx", "args": [ "mcp-clickhouse" ] } } }确认已连接
这个客户端的文档没有给出在这里传这些值的方法,请按服务器文档设置。
如果文件里已有其他服务器,把这一项加到已有的对象里。 确认是否已连接:重启或重新加载客户端,在它的 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
客户端兼容性
按传输方式判断:客户端文档列出的传输方式里是否有这个服务器提供的。不涉及登录等其他要求。
- Claude Code 支持该传输方式
- Cursor 支持该传输方式
- VS Code 客户端文档未列出传输方式
- Codex 支持该传输方式
- Devin Desktop 支持该传输方式
- Gemini CLI 支持该传输方式
- GitHub Copilot 客户端文档未列出传输方式
- Cline 支持该传输方式
- Kiro 支持该传输方式
- Zed 客户端文档未列出传输方式
- OpenCode 客户端文档未列出传输方式
- JetBrains AI Assistant 支持该传输方式
- Claude 客户端文档未列出传输方式
- ChatGPT 没有共同的传输方式
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
来源
- Official MCP Registry registry.modelcontextprotocol.io · 核对于 2026年11月4日
- GitHub organization ClickHouse (verified domain) github.com · 核对于 2026年11月4日
This data comes from the Official MCP Registry.