Aws Bedrock Guardrails MCP

🚀 Bedrock Guardrails MCP Server

このMCPサーバーは、AWS Bedrock Guardrailsのすべての管理機能をツールとして公開しています。これにより、ガードレール（すべてのポリシータイプを含む）をプログラムで、またはClaude DesktopのようなLLMを介して作成、編集、削除、およびエクスポートすることができます。また、インフラストラクチャをコードとして扱うワークフローのために、ガードレールの設定をTerraformファイルとしてエクスポートすることもサポートしています。

✨ 主な機能

• AWS Bedrock Guardrailsの作成、更新、削除、および一覧表示
• すべてのポリシータイプ（コンテンツ、トピック、単語、機密情報、コンテキストグラウンディングなど）の完全サポート
• 任意のガードレールをTerraformの.tfファイル（CloudFormationスキーマ）としてエクスポート
• 環境変数からのAWS資格情報を使用した安全な認証
• Claude DesktopまたはMCP互換のクライアントとの統合に対応

📦 インストール

前提条件

• Python 3.12以上
• uvパッケージマネージャー
• Bedrock Guardrailsのアクセス権限を持つAWSアカウント
• 環境に設定されたAWS資格情報（下記を参照）

セットアップ手順

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   uv venv
   source .venv/bin/activate
   uv pip install -r requirements.txt  # またはuvを使ってpyproject.tomlを使用
   

3. 環境にAWS資格情報を設定します。

   export AWS_ACCESS_KEY_ID=your-access-key
   export AWS_SECRET_ACCESS_KEY=your-secret-key
   export AWS_SESSION_TOKEN=your-session-token  # 一時的な資格情報を使用する場合
   export AWS_REGION=us-east-1  # または好みのリージョン
   

   ⚠️ 重要提示

   資格情報をソース管理にコミットしないでください。環境変数または安全な資格情報マネージャーを使用してください。

4. サーバーを起動します。

   uv run server.py
   

💻 使用例

基本的な使用法

• 完全なポリシー設定でガードレールを作成する： create_guardrail_fullツールを使用し、すべての必須およびオプションのポリシー設定を辞書として渡します。
• ガードレールを更新する： update_guardrail_fullをガードレールIDと更新するフィールドとともに使用します。
• Terraformにエクスポートする： export_guardrail_to_terraform(guardrail_id)を使用して、ガードレールの.tfリソースブロックを取得します。

Claude Desktopとの統合

このサーバーをClaude Desktopのツールとして使用するには、claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "BedrockGuardrailsMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/haji/mcp-servers/bedrock-guardrails-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

• ディレクトリパスを実際のプロジェクトの場所に置き換えてください。
• 設定を更新した後、Claude Desktopを再起動してください。

📚 詳細ドキュメント

影響とユースケース

• エンタープライズLLMの安全性： すべての生成AIアプリケーションのBedrock Guardrailsを集中管理し、自動化します。
• DevOpsとIaC： ガードレールをTerraformにエクスポートして、バージョン管理、再現性、およびCI/CD統合を行います。
• LLMツール： LLM（Claudeなど）が安全ポリシーをプログラムで管理し、監査し、リスクを是正できるようにします。

セキュリティ

• 資格情報は環境変数からのみ読み取られ、コードやログには保存されません。
• すべてのAWS API呼び出しは公式のboto3 SDKを使用して行われます。

📄 ライセンス

詳細はLICENSEファイルを参照してください。