Clickhouse Dataops Mcp

io.github.Aguantar由 GitHub 帳號 Aguantar 發布v0.1.1更新於 Oct 24, 2026

DataOps ClickHouse MCP server with query optimization and pipeline monitoring

已驗證STDIO僅桌面資料庫資料與分析

概覽

AI 產生的概覽

面向 ClickHouse DataOps 的本機 MCP 伺服器：執行唯讀 SELECT、分析與最佳化查詢，並檢視管線延遲、資料品質與磁碟使用情形。

可以做什麼
執行帶有分割區裁剪警告與列數限制的唯讀 SELECT 查詢，列出附說明的資料表，或檢視資料表結構、鍵與分割區資訊。透過 EXPLAIN 分析查詢並提供最佳化建議，診斷慢查詢。依區段監控 CDC 管線延遲（p50/p95/p99），偵測空值、重複、缺口與市場覆蓋等資料品質問題。分析磁碟用量並提供 TTL 與最佳化建議。
適用情境
適合在 DataOps 情境下讓助理排查 ClickHouse 資料倉儲：調校慢查詢、檢查管線延遲、驗證資料品質，或在沒有寫入權限的情況下檢視儲存與 TTL 設定。
執行需求
以 pip 安裝的 Python 套件形式在本機透過 stdio 執行。需要可存取的 ClickHouse HTTP 端點，以及環境變數 CLICKHOUSE_HOST、CLICKHOUSE_PORT、CLICKHOUSE_USER、CLICKHOUSE_PASSWORD 與 CLICKHOUSE_DATABASE；查詢逾時可透過 CLICKHOUSE_QUERY_TIMEOUT 設定。
安裝前請注意
需要透過 CLICKHOUSE_PASSWORD 提供 ClickHouse 密碼，應安全地存放在用戶端設定中。伺服器設計為唯讀，會攔截 DDL/DML、多語句查詢與不在允許清單中的系統表，但查詢仍會存取資料庫，可能將資料表資料暴露給助理。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Clickhouse Dataops Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

clickhouse-dataops-mcp

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

A DataOps-focused MCP server for ClickHouse with query optimization, pipeline latency analysis, and data quality monitoring.

Features

Unlike generic ClickHouse MCP servers that only run queries, this server acts as a query optimization advisor:

  • ch_query — Execute SELECT with automatic partition pruning warnings
  • ch_explain_query — EXPLAIN-based analysis with optimization suggestions
  • ch_table_schema — Comprehensive table metadata (columns, keys, partitions, samples)
  • ch_pipeline_latency — CDC pipeline per-segment latency (p50/p95/p99)
  • ch_data_quality — Null/duplicate/gap detection with market coverage checks
  • ch_slow_queries — Slow query detection with root cause diagnosis
  • ch_disk_usage — Disk analysis with TTL and optimization recommendations
  • ch_list_tables — Table catalog with built-in descriptions

Safety

All queries are read-only. DDL/DML operations are blocked at the SQL validation layer:

  • Blocked: DROP, TRUNCATE, DELETE, ALTER, INSERT, UPDATE, CREATE, etc.
  • Multi-statement queries blocked (; separator)
  • Comment-based bypass prevented (comments stripped before validation)
  • System tables restricted to allowlist
  • Query timeout: 30 seconds
  • Row limit enforcement

Installation

bash
pip install clickhouse-dataops-mcp

Usage with Claude Code

Add to your .mcp.json:

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

Environment Variables

VariableDefaultDescription
CLICKHOUSE_HOSTlocalhostClickHouse HTTP host
CLICKHOUSE_PORT8123ClickHouse HTTP port
CLICKHOUSE_USERdefaultClickHouse username
CLICKHOUSE_PASSWORD(empty)ClickHouse password
CLICKHOUSE_DATABASEcdc_pipelineDefault database
CLICKHOUSE_QUERY_TIMEOUT30Query timeout in seconds

License

MIT

來源：README.md，提交 82e819e

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分