JinDaGe - compliance-manager-mcp-server MCP Details

article

README

🚀 Google Cloud Compliance Manager MCP 服务器

这是一个用于与 Google Cloud Compliance Manager（Security Command Center Enterprise 的一部分）进行交互的 MCP（模型上下文协议）服务器。它能让 AI 助手（如 Claude）与 Google Cloud 的合规管理服务进行交互，为用户提供管理 Google Cloud 基础设施合规性的有效工具。

🚀 快速开始

详细的安装和设置说明请参考快速入门指南。

安装

# 安装 uv 包管理器
curl -LsSf https://astral.sh/uv/install.sh | sh

# 克隆仓库
git clone https://github.com/yourusername/compliance-manager-mcp-server.git
cd compliance-manager-mcp-server

# 安装依赖
uv pip install -e .

# 设置身份验证
gcloud auth application-default login

运行服务器

uv run compliance_manager_mcp.py

✨ 主要特性

可用工具

list_frameworks(organization_id, location="global", page_size=50)
- 描述：列出组织中所有可用的合规框架。框架可以是内置的（如 CIS、NIST、FedRAMP）或自定义的。
- 参数：
  - organization_id（必需）：Google Cloud 组织 ID（例如，'123456789012'）。
  - location（可选）：框架的位置。默认为 'global'。
  - page_size（可选）：返回的最大框架数。默认为 50。
get_framework(organization_id, framework_id, location="global")
- 描述：获取特定合规框架的详细信息，包括其云控制和监管控制映射。
- 参数：
  - organization_id（必需）：Google Cloud 组织 ID。
  - framework_id（必需）：要检索的框架的 ID。
  - location（可选）：框架的位置。默认为 'global'。
list_cloud_controls(organization_id, location="global", page_size=50)
- 描述：列出组织中所有可用的云控制。云控制是有助于满足合规要求的技术项。
- 参数：
  - organization_id（必需）：Google Cloud 组织 ID。
  - location（可选）：云控制的位置。默认为 'global'。
  - page_size（可选）：返回的最大云控制数。默认为 50。
get_cloud_control(organization_id, cloud_control_id, location="global")
- 描述：获取特定云控制的详细信息，包括其规则、参数和实施模式。
- 参数：
  - organization_id（必需）：Google Cloud 组织 ID。
  - cloud_control_id（必需）：要检索的云控制的 ID。
  - location（可选）：云控制的位置。默认为 'global'。
list_framework_deployments(parent, location="global", page_size=50)
- 描述：列出给定父资源（组织、文件夹或项目）的所有框架部署。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - location（可选）：部署的位置。默认为 'global'。
  - page_size（可选）：返回的最大部署数。默认为 50。
get_framework_deployment(parent, framework_deployment_id, location="global")
- 描述：获取特定框架部署的详细信息，包括其状态和配置。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - framework_deployment_id（必需）：要检索的框架部署的 ID。
  - location（可选）：部署的位置。默认为 'global'。
create_framework_deployment(parent, framework_deployment_id, framework_name, location="global", target_resource=None)
- 描述：在目标资源上创建新的框架部署。这将合规框架应用于组织、文件夹或项目。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - framework_deployment_id（必需）：新框架部署的 ID。
  - framework_name（必需）：要部署的框架的全名（例如，'organizations/{org_id}/locations/global/frameworks/{framework_id}'）。
  - location（可选）：部署的位置。默认为 'global'。
  - target_resource（可选）：目标资源名称。如果未提供，则使用父资源。
delete_framework_deployment(parent, framework_deployment_id, location="global")
- 描述：删除框架部署。这将从目标资源中移除合规框架。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - framework_deployment_id（必需）：要删除的框架部署的 ID。
  - location（可选）：部署的位置。默认为 'global'。
list_cloud_control_deployments(parent, location="global", page_size=50)
- 描述：列出给定父资源的所有云控制部署。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - location（可选）：部署的位置。默认为 'global'。
  - page_size（可选）：返回的最大部署数。默认为 50。
get_cloud_control_deployment(parent, cloud_control_deployment_id, location="global")
- 描述：获取特定云控制部署的详细信息，包括其实施模式和状态。
- 参数：
  - parent（必需）：父资源，格式为 'organizations/{org_id}'、'folders/{folder_id}' 或 'projects/{project_id}'。
  - cloud_control_deployment_id（必需）：要检索的云控制部署的 ID。
  - location（可选）：部署的位置。默认为 'global'。

📦 安装指南

MCP 服务器配置

将以下配置添加到 MCP 客户端的设置文件中：

⚠️ 重要提示

对于 OSX 用户，如果你使用此单行命令安装 uv，请在下面的 "command" 值中使用 uv 二进制文件的完整路径，因为 uv 不会被放置在系统路径中供 Claude 使用！例如：/Users/yourusername/.local/bin/uv 而不是仅使用 uv。

{
  "mcpServers": {
    "compliance-manager-mcp": {
      "command": "uv",
      "args": [
        "--env-file=/path/to/your/env",
        "--directory",
        "/path/to/the/repo",
        "run",
        "compliance_manager_mcp.py"
      ],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}

身份验证

服务器使用 Google Cloud 的身份验证机制。请确保在服务器运行的环境中配置了以下其中一项：

已设置应用默认凭据（ADC）（例如，通过 gcloud auth application-default login）。
GOOGLE_APPLICATION_CREDENTIALS 环境变量指向有效的服务帐户密钥文件。

所需的 IAM 权限

目标 Google Cloud 组织需要适当的 IAM 权限：

合规管理器：roles/securitycenter.complianceManager 或 roles/securitycenter.adminEditor
只读操作：roles/securitycenter.adminViewer

📚 详细文档

快速入门指南 - 几分钟内开始使用
使用指南 - 详细的示例和用例
贡献指南 - 如何为项目做出贡献

📄 许可证

本项目采用 Apache 2.0 许可证。

关于合规管理器

Google Cloud 中的合规管理器有助于确保你的 Google Cloud 基础设施、工作负载和数据满足安全和监管要求。它允许你：

定义和部署合规且安全的配置
查看显示与合规要求对齐情况的仪表板
审核云环境并生成评估报告
使用软件定义的控制来实现多个合规计划

更多信息，请参阅合规管理器文档。

支持

问题反馈：通过 GitHub 问题报告错误或请求功能。
文档查阅：请参阅文档。
社区交流：加入仓库中的讨论。

致谢

本项目受 Google MCP Security 仓库的启发，并遵循类似的 MCP 服务器实现模式。

项目结构

compliance-manager-mcp-server/
├── compliance_manager_mcp.py    # 主 MCP 服务器实现
├── pyproject.toml               # 项目依赖和元数据
├── setup.py                     # 设置配置
├── README.md                    # 本文件
├── QUICKSTART.md                # 快速入门指南
├── USAGE.md                     # 详细使用示例
├── CONTRIBUTING.md              # 贡献指南
├── LICENSE                      # Apache 2.0 许可证
├── .env.example                 # 示例环境配置
├── .gitignore                   # Git 忽略规则
├── mcp_settings.json.example    # 示例 MCP 客户端配置
└── test_import.py               # 导入测试脚本

compliance-manager-mcp-server