acuvity/mcp-server-clickhouse

mcp-server-clickhouse镜像说明

镜像概述

mcp-server-clickhouse是由Acuvity打包的MCP服务器镜像，用于查询ClickHouse数据库服务器。该镜像基于可靠来源构建，具备严格的安全特性，支持多环境部署和IDE集成。

核心功能

安全特性

运行时安全护栏

• 资源完整性：嵌入资源哈希，防止未授权修改
• 隐蔽指令检测：识别请求中的隐藏或混淆指令
• 敏感模式检测：标记敏感数据或文件系统暴露模式
• 模式误用预防：强制输入数据严格符合 schema
• 跨源工具访问控制：管理外部服务或API调用
• secrets 脱敏：防止凭证或敏感值暴露
• 基础认证：配置共享密钥限制未授权访问

使用场景

• 本地开发环境中查询ClickHouse数据库
• 远程部署的MCP服务集成
• Kubernetes集群中的容器化部署
• 多IDE（VS Code、Windsurf等）的Copilot增强

配置说明

环境变量

• 必填：CLICKHOUSE_HOST、CLICKHOUSE_USER、CLICKHOUSE_PASSWORD
• 可选：CLICKHOUSE_PORT、CLICKHOUSE_SECURE、CLICKHOUSE_VERIFY、CLICKHOUSE_CONNECT_TIMEOUT、CLICKHOUSE_SEND_RECEIVE_TIMEOUT、CLICKHOUSE_DATABASE

部署示例

Docker运行（本地HTTP/sse模式）

bash
docker run -it -p 8000:8000 --rm --read-only --tmpfs /tmp:rw,nosuid,nodev -e CLICKHOUSE_HOST=your_host -e CLICKHOUSE_USER=your_user -e CLICKHOUSE_PASSWORD=your_password docker.io/acuvity/mcp-server-clickhouse:0.1.13

VS Code集成（全局配置）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-clickhouse": {
        "env": {
          "CLICKHOUSE_HOST": "TO_BE_SET",
          "CLICKHOUSE_PASSWORD": "TO_BE_SET",
          "CLICKHOUSE_USER": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "--tmpfs",
          "/tmp:rw,nosuid,nodev",
          "-e",
          "CLICKHOUSE_HOST",
          "-e",
          "CLICKHOUSE_USER",
          "-e",
          "CLICKHOUSE_PASSWORD",
          "docker.io/acuvity/mcp-server-clickhouse:0.1.13"
        ]
      }
    }
  }
}

Kubernetes部署（Helm）

bash
helm install mcp-server-clickhouse oci://docker.io/acuvity/mcp-server-clickhouse --version 1.0.0 --set env.CLICKHOUSE_HOST=your_host,env.CLICKHOUSE_USER=your_user,secrets.CLICKHOUSE_PASSWORD.value=your_password

验证镜像签名

使用Cosign验证：

bash
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-clickhouse:latest

更多详细信息请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-clickhouse%E3%80%82 ===FULL_DESC===