Aws Bedrock Guardrails

Bedrock Guardrails MCP サーバー

説明

この 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  # or use pyproject.toml with uv
   

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  # if using temporary credentials
   export AWS_REGION=us-east-1  # or your preferred region
   

   セキュリティに関する注意： 認証情報をソース管理にコミットしないでください。環境変数または安全な認証情報マネージャーを使用してください。

4. サーバーを実行します：

   uv run server.py
   

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 を再起動します。

使用例

• すべてのポリシー設定を含むガードレールの作成： create_guardrail_full ツールを使用し、必須および任意のポリシー設定を辞書として渡します。
• ガードレールの更新： ガードレール ID と更新するフィールドを指定して update_guardrail_full を使用します。
• Terraform へのエクスポート： export_guardrail_to_terraform(guardrail_id) を使用すると、ガードレールの .tf リソースブロックを取得できます。

スクリーンショット

影響とユースケース

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

セキュリティ

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

ライセンス

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