Compliance Manager MCP Server

🚀 Google Cloud Compliance Manager MCP Server

このプロジェクトは、Security Command Center Enterpriseの一部であるGoogle Cloud Compliance Managerとやり取りするためのMCP（Model Context Protocol）サーバーです。AIアシスタントがGoogle Cloudのコンプライアンス管理サービスと連携できるようになります。

🚀 クイックスタート

詳細なインストールとセットアップ手順については、QUICKSTART.mdを参照してください。

インストール

# 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が使用できません。例えば、uv の代わりに /Users/yourusername/.local/bin/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

🔧 技術詳細

プロジェクト構造

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について

Google CloudのCompliance Managerは、Google Cloudインフラストラクチャ、ワークロード、およびデータがセキュリティと規制要件を満たすことを保証するのに役立ちます。以下のことができます。

• コンプライアントでセキュアな構成を定義してデプロイする
• コンプライアンス要件との整合性を示すダッシュボードを表示する
• クラウド環境を監査し、評価レポートを生成する
• 複数のコンプライアンスプログラムに対するソフトウェア定義コントロールを使用する

詳細については、Compliance Managerのドキュメントを参照してください。

サポート

• 問題報告: GitHub Issues を通じてバグを報告または機能をリクエストしてください。
• ドキュメント: ドキュメント を参照してください。
• コミュニティ: リポジトリ内で議論に参加してください。

謝辞

このプロジェクトは、Google MCP Security リポジトリに触発されており、MCPサーバーの実装に類似したパターンを採用しています。