Compliance Manager MCP Server

🚀 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 的身份驗證機制。請確保在服務器運行的環境中配置了以下其中一項：

1. 已設置應用默認憑據（ADC）（例如，通過 gcloud auth application-default login）。
2. 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               # 導入測試腳本