acuvity/mcp-server-google-bigquery

mcp-server-google-bigquery 镜像说明

镜像概述

本镜像由Acuvity打包发布，基于@ergut/mcp-bigquery-server原始项目，提供安全可靠的服务器服务，让大语言模型（LLM）能够安全查询Google BigQuery数据。镜像强调安全设计，包含隔离执行环境、非root运行、只读文件系统等核心安全特性，确保服务稳定与数据安全。

核心功能

隔离沙箱与安全特性

• 隔离执行：工具在容器化沙箱内运行，防止横向移动。
• 非root默认：遵循最小权限原则，降低安全漏洞影响。
• 只读文件系统：确保运行时不可变性，防止未授权修改。
• 版本固定：锁定工具与依赖版本，保证部署一致性。
• CVE扫描：通过Docker Scout持续扫描已知漏洞。
• SBOM与溯源：嵌入元数据与可追溯构建信息，提升供应链透明度。
• 容器签名：使用Cosign进行镜像签名，确保完整性与真实性。

运行时安全护栏

默认关闭（除资源完整性外），可按需启用：

• 资源完整性：验证暴露资源的哈希，防止篡改。
• 隐蔽指令检测：识别请求中的隐藏或混淆指令。
• 敏感模式检测：标记敏感数据或文件系统暴露模式。
• 秘密信息脱敏：防止凭证或敏感值泄露。
• 基础认证：通过共享密钥限制未授权访问。

使用场景

适用于需要LLM查询BigQuery数据的场景，支持以下客户端集成：

• Visual Studio Code
• Windsurf IDE
• Cursor IDE
• Claude Desktop
• OpenAI Python SDK

配置说明

环境变量要求

• GCP_PROJECT_ID：必填，Google Cloud项目ID。
• GCP_REGION：必填，Google Cloud区域。

部署示例

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

bash
docker run -it -p 8000:8000 --rm --read-only -e GCP_PROJECT_ID=<你的项目ID> -e GCP_REGION=<你的区域> docker.io/acuvity/mcp-server-google-bigquery:1.0.3

Kubernetes Helm部署

bash
helm install mcp-server-google-bigquery oci://docker.io/acuvity/mcp-server-google-bigquery --version 1.0.0 --set secrets.GCP_PROJECT_ID.value=<你的项目ID> --set env.GCP_REGION=<你的区域>

VS Code集成（全局配置）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-google-bigquery": {
        "env": {
          "GCP_PROJECT_ID": "TO_BE_SET",
          "GCP_REGION": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "GCP_PROJECT_ID",
          "-e",
          "GCP_REGION",
          "docker.io/acuvity/mcp-server-google-bigquery:1.0.3"
        ]
      }
    }
  }
}

更多配置细节请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-google-bigquery%E3%80%82 ===FULL_DESC===