Google Native MCP Server

🛡️ MCP Boss——自主安全操作服务器

91个工具。 一个端点。用简单的英语与你的整个谷歌安全堆栈交谈。

MCP Boss允许任何AI模型（Gemini、Claude、GPT）通过 模型上下文协议.

______________________________________________________________________

快速开始

单线安装：

curl -sL https://raw.githubusercontent.com/dadohen/MCP-Boss/main/setup.sh | bash -s -- \
  --project your-project-id \
  --customer your-secops-customer-id \
  --gti-key your-vt-api-key

或者从Google Cloud Shell进行部署：


Cloud Shell打开后，在终端中运行：

chmod +x setup.sh && ./setup.sh

向导将引导您完成项目ID、客户ID，并部署所有内容。

或者一步一步：

git clone https://github.com/dadohen/MCP-Boss.git
cd MCP-Boss && ./setup.sh

安装向导处理一切：API、服务帐户、IAM角色、容器构建、云运行部署和验证。

______________________________________________________________________

它做什么

你问了一个问题→ Gemini选择合适的工具→ 执行它们→ 跨多个来源的链结果→ 给你一份报告。没有点击UI，没有编写API调用，没有切换控制台。

例子： *“在所有来源中寻找APT28”* →

1. 通过GTI/VirusTotal查找APT28威胁情报
2. 在SIEM中搜索匹配的IOC
3. 检查SCC是否存在与其TTP匹配的可利用漏洞
4. 将所有来源的调查结果相关联
5. 编制一份载有建议行动的执行摘要

全自动，一个请求中最多可调用20个链式工具。

______________________________________________________________________

基准

首次在实时Cloud run部署上进行基准测试（2026-04-22，gemini-2.5-flash，6种场景）：

完整的记分卡、场景和原始工具跟踪在 eval_harness/ (scorecard-2026-04-22.md, results.json).随时重新运行 ./eval_harness/run.sh这一类别中没有其他人可信地公布这些数字；这就是重点。

______________________________________________________________________

建筑

┌──────────────────────────────────────────────────────────────┐
│                     USER INTERFACES                          │
│   Web UI  ·  Gemini CLI  ·  Claude Desktop  ·  Mobile App   │
└──────────────────────┬───────────────────────────────────────┘
                       │
          ┌────────────┴────────────┐
          │ /api/chat (Web UI)      │  ← Multi-turn orchestration
          │ /mcp     (Gemini CLI)   │  ← Streamable HTTP
          │ /sse     (Claude/MCP)   │  ← SSE transport
          └────────────┬────────────┘
                       │
┌──────────────────────▼───────────────────────────────────────┐
│              MCP Boss Server (Cloud Run)                      │
│              89 Tools · Python · FastMCP · Serverless         │
│                                                              │
│  🔍 Discovery    🧠 Intel       🛡️ Detection    📂 SOAR     │
│  ├─ SCC          ├─ GTI/VT      ├─ YARA-L       ├─ Cases    │
│  ├─ Cloud Log    ├─ Malware     ├─ Rules         ├─ Playbooks│
│  ├─ UDM Search   ├─ Actors      ├─ Alerts        ├─ Actions  │
│  ├─ Ingestion    └─ Vertex AI   └─ Data Tables   └─ Metrics  │
│                                                              │
│  📧 Containment  ☁️ Cloud        📊 Analytics                │
│  ├─ O365 Purge   ├─ AWS Keys    ├─ BigQuery                 │
│  ├─ Okta         ├─ GCP SA      ├─ MTTx Metrics             │
│  ├─ Azure AD     ├─ STS Revoke  ├─ Audit Logs               │
│  └─ CrowdStrike  └─ IAM Review  └─ Cloud Monitoring         │
└──────────────────────────────────────────────────────────────┘
                       │
          ┌────────────┴────────────┐
          │  Google Cloud APIs       │
          │  Chronicle · SCC · GTI   │
          │  Vertex AI · BigQuery    │
          │  Cloud Logging · IAM     │
          │  Cloud Monitoring        │
          └─────────────────────────┘

零嵌入秘密。 所有Google API身份验证都使用工作负载身份联合身份验证（应用程序默认凭据）。Cloud Run服务帐户会自动进行身份验证。第三方遏制API（Okta、AWS、Azure AD、CrowdStrike、O365）使用由Secret Manager支持的环境变量。

______________________________________________________________________

安全

MCP Boss处理敏感的安全数据。以下是如何将其锁定。

认证关闭等于政策关闭。 当 OAUTH_CLIENT_ID 未设置，内置身份验证中间件无操作，审批角色签入 /api/approvals/*/decide 回退到允许所有路径，以便开发工作流继续工作。这意味着部署时没有 OAUTH_CLIENT_ID 没有强制执行：任何拥有网络覆盖范围的人都可以批准任何破坏性的工具调用。任何非开发部署都必须设置 OAUTH_CLIENT_ID （并填充 ROLE_MAP_JSON 或 ROLE_MAP_PATH).看 auth_middleware.py 和 deploy/multi_tenant/README.md. 如果出现以下情况，Boot将拒绝启动 LOCAL_DEV_ALL_ROLES=1 未设置 OAUTH_CLIENT_ID 除非你也设置 MCP_BOSS_ENV=dev。该组合授予每个呼叫者每个审批者角色。 MCP传输（stdio/SSE）会话工具(create_session, get_session, update_session, add_note)仍然在单个租户下运行，因为这些传输不携带HTTP标识。在基础层限制MCP传输访问（Cloud Run IAM调用程序在 /mcp 和 /sse).

选项1:IAM身份验证（推荐）

删除公共访问并要求Google Cloud IAM身份验证：

# Remove unauthenticated access
gcloud run services remove-iam-policy-binding mcp-boss \
  --member="allUsers" \
  --role="roles/run.invoker" \
  --project=$PROJECT_ID \
  --region=us-central1

# Grant access to specific users only
gcloud run services add-iam-policy-binding mcp-boss \
  --member="user:analyst@yourcompany.com" \
  --role="roles/run.invoker" \
  --project=$PROJECT_ID \
  --region=us-central1

# Grant access to a Google Group (for SOC team)
gcloud run services add-iam-policy-binding mcp-boss \
  --member="group:soc-team@yourcompany.com" \
  --role="roles/run.invoker" \
  --project=$PROJECT_ID \
  --region=us-central1

锁定后如何访问：

# From browser — use Cloud Run Proxy:
gcloud run services proxy mcp-boss --project=$PROJECT_ID --region=us-central1
# Opens http://localhost:8080 → authenticated tunnel to your service

# From curl/API:
TOKEN=$(gcloud auth print-identity-token)
curl -H "Authorization: Bearer $TOKEN" https://YOUR-SERVICE-URL/health

# From Gemini CLI:
TOKEN=$(gcloud auth print-identity-token)
gemini --tool-endpoint https://YOUR-SERVICE-URL/mcp --headers "Authorization=Bearer $TOKEN"

选项2：仅VPC（内部网络）

仅限于您的VPC——完全没有公共互联网接入：

gcloud run services update mcp-boss \
  --ingress=internal \
  --project=$PROJECT_ID \
  --region=us-central1

只能从VPC、VPN或云互连中访问。

如何访问：

# From your local machine via Cloud Run Proxy (tunnels through IAM):
gcloud run services proxy mcp-boss --project=$PROJECT_ID --region=us-central1
# Opens http://localhost:8080 locally

# Or from a GCE VM / GKE pod inside the VPC:
curl https://YOUR-SERVICE-URL/health

选项3:IAP（身份感知代理）

将Cloud IAP放在前面，以便与您的企业身份提供商进行基于浏览器的SSO：

# Enable IAP on the Cloud Run service
gcloud iap web enable \
  --resource-type=cloud-run \
  --service=mcp-boss \
  --project=$PROJECT_ID

# Grant access to your SOC team
gcloud iap web add-iam-policy-binding \
  --resource-type=cloud-run \
  --service=mcp-boss \
  --member="group:soc-team@yourcompany.com" \
  --role="roles/iap.httpsResourceAccessor" \
  --project=$PROJECT_ID

用户在到达Web UI之前，浏览器中会出现谷歌登录提示。无需更改代码——IAP处理一切。

如何访问： 只需在浏览器中打开URL即可。IAP显示了一个谷歌登录页面。登录后，您将进入Web UI。

选项4：API密钥头

为了快速保护，请设置API密钥环境变量并在请求中验证：

gcloud run services update mcp-boss \
  --set-env-vars="MCP_BOSS_API_KEY=your-secret-key-here" \
  --project=$PROJECT_ID \
  --region=us-central1

如何访问：

# curl:
curl -H "X-API-Key: your-secret-key-here" https://YOUR-SERVICE-URL/health

# Gemini CLI:
gemini --tool-endpoint https://YOUR-SERVICE-URL/mcp --headers "X-API-Key=your-secret-key-here"

# Web UI: Add ?key=your-secret-key-here to the URL
# Or the Web UI will prompt for it on first load

当以下情况发生时，服务器会自动验证 MCP_BOSS_API_KEY 已设置。

安全最佳实践

______________________________________________________________________

身份验证和批准

位于Cloud Run IAM之上的应用程序级控件。默认情况下，它们都是关闭的；使用env变量选择加入。

身份验证（Google ID令牌）

集 OAUTH_CLIENT_ID 服务器拒绝任何没有有效Google OIDC ID令牌的请求 aud 比赛。

当 OAUTH_CLIENT_ID 如果未设置，则中间件为无操作：auth已禁用，主体为 local，每个角色检查都通过。请勿将此配置发布到本地开发之外。如果出现以下情况，服务器将拒绝启动 LOCAL_DEV_ALL_ROLES=1 未设置任何一个 OAUTH_CLIENT_ID 或 MCP_BOSS_ENV=dev.

角色映射和审批人组

policy_and_approvals/policies.yaml 将每个破坏性工具（主机隔离、密钥撤销、电子邮件清除等）映射到一个或多个审批者角色名称。要授权呼叫者，请将他们的电子邮件映射到角色集。

默认情况下识别的审批人角色名称 policies.yaml: security-oncall, soc-manager, identity-team, cloud-platform, detection-engineering, legal, security-leadership.

审批工作流程

1. 编排器想要调用门控工具（例如。 isolate_crowdstrike_host).
2. 政策关卡检查 policies.yaml.如果 require_approval，它将工具调用冻结为 ApprovalRequest.
3. 批准通过任何配置的频道进行广播： /api/approvals （网络用户界面），谷歌聊天卡(GOOGLE_CHAT_WEBHOOK_URL)，通用webhook(APPROVAL_WEBHOOK_URL).
4. 审批人点击 POST /api/approvals/{id}/decide 和 approve / deny除非经过身份验证的呼叫者的角色与规则的角色相交，否则服务器403s approver_groups. decided_by 会反弹到经过身份验证的电子邮件，因此审计跟踪不会被欺骗。
5. 批准后，工具将执行。每个状态转换都会记录在哈希链审计日志中。

随时通过以下方式验证链条 GET /api/audit/verify:

{"chain_intact": true, "broken_at_seq": null, "audit_path": "/var/log/mcp-boss/audit.jsonl"}

租户隔离

SessionMemory 由（经过身份验证的主体，session_id）键入。同一Cloud Run实例上的两个用户即使猜测会话ID，也无法读取彼此的调查历史记录。MCP传输会话工具（stdio/SSE）使用不同的 mcp-transport 名称空间；在底层传输的网关（Cloud Run IAM调用程序在 /mcp 和 /sse).

输出编辑（DLP）

集 ENABLE_OUTPUT_REDACTION=1 并且在每个工具结果流回到LLM或API响应之前对其进行扫描。Luhn-checked CC number，SSN-looking string（with IP/date guard），PEM私钥，AWS访问密钥，JWT，and labeled API密钥（GTI，Okta，CrowdStrike，Azure AD，O365， api_key, bearer_token, client_secret, access_token)被替换为 [REDACTED:]审计日志记录了未编辑的内容；只有跨越工具到LLM边界的内容才会被净化。

______________________________________________________________________

运营

日常使用

• Web用户界面 --浏览到Cloud Run URL，使用Google登录。粘贴提醒或提问。
• Gemini CLI — gemini --tool-endpoint https://YOUR-URL/mcp --headers "Authorization=Bearer $(gcloud auth print-identity-token)".
• 克劳德桌面 --添加 /sse URL到 claude_desktop_config.json （请参阅连接部分）。

每个请求都会生成一个聊天记录（在web UI中）、一个完整的工具跟踪（在Cloud Logging中）以及任何门控工具调用的审计记录。

基准/回归

export MCP_URL=https://YOUR-SERVICE-URL
export MCP_ID_TOKEN=$(gcloud auth print-identity-token)
./eval_harness/run.sh

生产 scorecard.md （标题数字）和 results.json （每个场景的原始工具跟踪）。将其连接到CI，如果出现以下情况，则构建失败 destructive_fp_rate_pct > 0 或者判决准确性下降。

审计日志导出

记录为JSONL格式 $MCP_BOSS_AUDIT_PATH （默认值 /var/log/mcp-boss/audit.jsonl，回落到 ~/.mcp-boss/audit.jsonl)并在日志名称下镜像到Cloud Logging mcp-boss-audit将BigQuery接收器指向Cloud Logging流，以实现长期保留和SIEM摄取。

多租户安装

deploy/multi_tenant/install.sh 跑 terraform apply 在一个命令中使用Artifact Registry、Secret Manager存根、Cloud Run v2和IAM绑定。通过 --oauth-client-id, --allowed-emails, --role-map-json，以及 --enable-redaction 在部署时设置完整的auth配置。

______________________________________________________________________

手动设置指南

如果您更喜欢手动设置而不是使用 setup.sh:

先决条件

• 启用计费的Google Cloud项目
• gcloud CLI已安装并经过身份验证
• 具有客户ID的Chronicle/SecOps实例

步骤1：启用API

PROJECT_ID=your-project-id

gcloud services enable \
    run.googleapis.com \
    cloudbuild.googleapis.com \
    chronicle.googleapis.com \
    securitycenter.googleapis.com \
    aiplatform.googleapis.com \
    logging.googleapis.com \
    bigquery.googleapis.com \
    monitoring.googleapis.com \
    iam.googleapis.com \
    cloudresourcemanager.googleapis.com \
    --project=$PROJECT_ID

步骤2：创建服务帐户并授予IAM角色

SA_NAME=mcp-boss
SA_EMAIL="${SA_NAME}@${PROJECT_ID}.iam.gserviceaccount.com"

# Create the service account
gcloud iam service-accounts create $SA_NAME \
  --display-name="MCP Boss Service Account" \
  --project=$PROJECT_ID

# Grant required roles
ROLES=(
  roles/chronicle.admin
  roles/securitycenter.findingsViewer
  roles/aiplatform.user
  roles/logging.viewer
  roles/bigquery.dataViewer
  roles/bigquery.jobUser
  roles/monitoring.viewer
  roles/iam.securityReviewer
)

for ROLE in "${ROLES[@]}"; do
  gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:${SA_EMAIL}" \
    --role="$ROLE" --quiet
done

IAM角色参考

步骤3：构建和部署

# Build
gcloud builds submit \
  --project=$PROJECT_ID \
  --tag gcr.io/$PROJECT_ID/mcp-boss:latest

# Deploy
gcloud run deploy mcp-boss \
  --image gcr.io/$PROJECT_ID/mcp-boss:latest \
  --project=$PROJECT_ID \
  --region=us-central1 \
  --platform=managed \
  --service-account=$SA_EMAIL \
  --allow-unauthenticated \
  --memory=512Mi \
  --timeout=300 \
  --set-env-vars="SECOPS_PROJECT_ID=$PROJECT_ID,SECOPS_CUSTOMER_ID=YOUR_CUSTOMER_ID,SECOPS_REGION=us,GTI_API_KEY=YOUR_VT_KEY"

步骤4：验证

curl https://YOUR-SERVICE-URL/health
# {"status":"healthy","tools":89,...}

步骤5：连接

Web用户界面： 在浏览器中打开您的Cloud Run URL。

Gemini CLI：

gemini --tool-endpoint https://YOUR-SERVICE-URL/mcp

克劳德桌面 (claude_desktop_config.json):

{
  "mcpServers": {
    "mcp-boss": {
      "url": "https://YOUR-SERVICE-URL/sse"
    }
  }
}

______________________________________________________________________

环境变量

必需

推荐

认证

运营

可选——第三方遏制

任何敏感的环境变量都可以接受 sm://PROJECT/SECRET_NAME 代替明文值。这 secrets_resolver 该模块在启动时透明地从Google Secret Manager获取最新版本。

______________________________________________________________________

全部91个工具

🔍 探索与狩猎（12个工具）

🧠 威胁情报（6种工具）

🛡️ 检测工程（8个工具）

📋 数据表（3个工具）

📂 SOAR案例（17个工具）

🎭 SOAR播放手册（6个工具）

🔒 围堵（7个工具）

📊 记录和监控（6个工具）

🔧 SecOps管理员（7个工具）

📊 分析（5个工具）

🔑 IAM（3个工具）

🧠 会话和调查（5个工具）

______________________________________________________________________

API终点

______________________________________________________________________

作者

大卫·阿登 --谷歌安全行动/谷歌威胁情报