xTag

镜像概览

完整引用
docker.io/mcp/clickhouse
Registry
docker.io
命名空间
mcp
仓库
clickhouse
已缓存 Tag 数
1
最近同步
07/06/2026, 11:51 AM
相关主题
数据库与缓存

简介

ClickHouse MCP Server 镜像，为 AI Agent 暴露 SQL 查询与 schema 探索工具，需配合 ClickHouse 实例与 LLM 客户端。

详细介绍

mcp/clickhouse 实现 Model Context Protocol 服务端，允许 Cursor/Claude 等 Agent 通过标准工具调用执行只读或受限 SQL。典型用于数据分析 Agent PoC，让 LLM 直接查询 OLAP 表而不手写 JDBC。定位为无状态 API 中间层，需 ClickHouse 凭据与网络连通；生产应固定 tag、只读账号与查询 timeout 限制。

快速启动

docker run -d --name mcp-clickhouse \
  -p 8080:8080 \
  -e CLICKHOUSE_HOST=clickhouse \
  -e CLICKHOUSE_USER=default \
  docker.io/mcp/clickhouse:latest

推荐实践

docker run -d --name mcp-clickhouse \
  --restart unless-stopped \
  -p 8080:8080 \
  -e CLICKHOUSE_HOST=clickhouse.internal \
  -e CLICKHOUSE_USER=mcp_readonly \
  -e CLICKHOUSE_PASSWORD=strong-pass \
  -e MCP_AUTH_TOKEN=random-token \
  docker.io/mcp/clickhouse:0.1.0

核心参数说明

  • -p 8080:8080 — MCP HTTP/SSE 服务端口
  • -e CLICKHOUSE_HOST/USER/PASSWORD — ClickHouse 连接凭据
  • -e MCP_AUTH_TOKEN — Agent 调用鉴权（高敏）
  • --restart unless-stopped — MCP 端点持续可用
  • 固定 tag — MCP 协议与驱动版本 pin
  • 权限 — 生产使用只读账号

Kubernetes

apiVersion: apps/v1
kind: Deployment
metadata:
  name: mcp-clickhouse
spec:
  replicas: 2
  selector:
    matchLabels:
      app: mcp-clickhouse
  template:
    metadata:
      labels:
        app: mcp-clickhouse
    spec:
      containers:
        - name: mcp
          image: docker.io/mcp/clickhouse:0.1.0
          ports:
            - containerPort: 8080
          envFrom:
            - secretRef:
                name: mcp-clickhouse-secrets
---
apiVersion: v1
kind: Service
metadata:
  name: mcp-clickhouse
spec:
  selector:
    app: mcp-clickhouse
  ports:
    - port: 8080
      targetPort: 8080

ClickHouse 独立 Service；NetworkPolicy 限制 MCP 仅内网 Agent 访问，Secret 轮换只读凭据。

最新 Tag（20 条）

查看全部 1 个 Tag →
Tag架构推送时间大小Digest同步期望操作
docker.io/mcp/clickhouse
:latest
linux/amd64linux/arm64
2025/11/01 05:30332.3 MBsha256:cb593c7a8d53…