clickhouse-dataops-mcp

Name: clickhouse-dataops-mcp
Author: Aguantar

本地服务

github.com/Aguantar数据库032 周前更新

代码仓库

关于 clickhouse-dataops-mcp

clickhouse-dataops-mcp 是面向 DataOps 团队的只读 ClickHouse MCP 服务，结合查询执行、优化建议、管道延迟分析和数据质量检查。它在基础查询之外提供诊断能力和安全控制。

主要功能

01执行 SELECT 并提示分区问题
02用 EXPLAIN 分析查询
03查看表结构和目录
04测量 CDC 管道延迟
05检测数据质量问题
06诊断慢查询和磁盘用量

适用场景

01检查查询计划和优化选项
02监控 CDC 各段延迟
03检查表中的空值、重复项和缺口
04排查慢查询与存储用量

MCP 相关

向 MCP 客户端提供 ClickHouse 查询和 DataOps 诊断工具。查询为只读，DDL、DML 和多语句输入均会被阻止。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "aguantar-clickhouse-dataops": {
      "command": "uvx",
      "args": [
        "clickhouse-dataops-mcp"
      ],
      "env": {
        "CLICKHOUSE_HOST": "<CLICKHOUSE_HOST>",
        "CLICKHOUSE_PORT": "<CLICKHOUSE_PORT>",
        "CLICKHOUSE_PASSWORD": "<CLICKHOUSE_PASSWORD>"
      }
    }
  }
}

启动命令uvx clickhouse-dataops-mcp

需要配置的环境变量

CLICKHOUSE_HOSTClickHouse HTTP host

CLICKHOUSE_PORTClickHouse HTTP port

CLICKHOUSE_PASSWORD密钥ClickHouse password

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiclickhouse-dataops-mcp0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

clickhouse-dataops-mcp

mcp-name: io.github.Aguantar/clickhouse-dataops-mcp

一款面向 DataOps 的 ClickHouse MCP 服务，提供查询优化、流水线延迟分析和数据质量监控。

功能

与仅执行查询的通用 ClickHouse MCP 服务不同，本服务可作为查询优化顾问：

ch_query — 执行 SELECT，并自动警告分区裁剪问题
ch_explain_query — 基于 EXPLAIN 进行分析并提供优化建议
ch_table_schema — 提供全面的表元数据（列、键、分区、样本）
ch_pipeline_latency — 按 CDC 流水线各阶段分析延迟（p50/p95/p99）
ch_data_quality — 检测空值、重复项和缺口，并检查市场覆盖情况
ch_slow_queries — 检测慢查询并诊断根本原因
ch_disk_usage — 分析磁盘使用情况，并提供 TTL 和优化建议
ch_list_tables — 提供内置说明的表目录

安全性

所有查询均为只读。SQL 验证层会阻止 DDL/DML 操作：

阻止：DROP、TRUNCATE、DELETE、ALTER、INSERT、UPDATE、CREATE 等
阻止多语句查询（使用 ; 分隔）
防止基于注释的绕过（验证前会移除注释）
系统表仅限访问允许列表中的表
查询超时：30 秒
强制限制行数

安装

pip install clickhouse-dataops-mcp

与 Claude Code 配合使用

添加到 .mcp.json：

{
  "mcpServers": {
    "clickhouse": {
      "command": "clickhouse-mcp-server",
      "env": {
        "CLICKHOUSE_HOST": "localhost",
        "CLICKHOUSE_PORT": "8123",
        "CLICKHOUSE_DATABASE": "cdc_pipeline"
      }
    }
  }
}

环境变量

变量	默认值	描述
`CLICKHOUSE_HOST`	`localhost`	ClickHouse HTTP 主机
`CLICKHOUSE_PORT`	`8123`	ClickHouse HTTP 端口
`CLICKHOUSE_USER`	`default`	ClickHouse 用户名
`CLICKHOUSE_PASSWORD`	（空）	ClickHouse 密码
`CLICKHOUSE_DATABASE`	`cdc_pipeline`	默认数据库
`CLICKHOUSE_QUERY_TIMEOUT`	`30`	查询超时时间（秒）