acuvity/mcp-server-datahub

mcp-server-datahub 镜像说明

镜像概述

mcp-server-datahub镜像是由Acuvity打包的工具，基于DataHub元数据系统，支持搜索数据资产、遍历数据 lineage、编写SQL查询等功能，同时集成了隔离沙箱、非root运行、只读文件系统等安全特性，确保运行可靠与安全。

核心功能

• 数据资产搜索：快速定位各类数据资产（如数据集、表、字段等）
• 数据 lineage 追踪：可视化数据的来源、流向及依赖关系
• SQL查询支持：直接基于元数据编写并执行SQL查询
• 安全防护：包含隔离执行环境、非root默认运行、只读文件系统、CVE扫描等安全措施

使用场景

• 数据治理：帮助团队统一管理数据资产，提升数据透明度
• 开发调试：开发人员快速获取数据元信息，辅助调试工作
• 数据分析：分析师通过元数据理解数据上下文，提高分析效率

配置说明

环境变量（必填）

• DATAHUB_GMS_URL：DataHub GMS服务的访问地址
• DATAHUB_GMS_TOKEN：访问DataHub GMS的授权令牌

部署示例

Docker本地运行（STDIO模式）

console
docker run -i --rm --read-only -e DATAHUB_GMS_URL=<你的GMS地址> -e DATAHUB_GMS_TOKEN=<你的令牌> docker.xuanyuan.run/acuvity/mcp-server-datahub:0.4.0

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

console
docker run -it -p 8000:8000 --rm --read-only -e DATAHUB_GMS_URL=<你的GMS地址> -e DATAHUB_GMS_TOKEN=<你的令牌> docker.xuanyuan.run/acuvity/mcp-server-datahub:0.4.0

VS Code配置（全局范围）

打开用户设置JSON，添加以下内容：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-datahub": {
        "env": {
          "DATAHUB_GMS_TOKEN": "TO_BE_SET",
          "DATAHUB_GMS_URL": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "DATAHUB_GMS_URL",
          "-e",
          "DATAHUB_GMS_TOKEN",
          "docker.io/acuvity/mcp-server-datahub:0.4.0"
        ]
      }
    }
  }
}

Helm部署（Kubernetes）

console
helm install mcp-server-datahub oci://docker.io/acuvity/mcp-server-datahub --version 1.0.0 \
  --set env.DATAHUB_GMS_URL=<你的GMS地址> \
  --set secrets.DATAHUB_GMS_TOKEN.value=<你的令牌>

更多配置细节可参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-datahub%E3%80%82