Aws Bedrock Guardrails MCP

🚀 Bedrock Guardrails MCP 服務器

本 MCP 服務器將所有 AWS Bedrock Guardrails 管理功能作為工具公開，允許你以編程方式或通過像 Claude Desktop 這樣的大語言模型來創建、編輯、刪除和導出護欄（包括所有策略類型）。它還支持將護欄配置導出為 Terraform 文件，以用於基礎設施即代碼的工作流程。

🚀 快速開始

本 MCP 服務器將 AWS Bedrock Guardrails 的各項管理功能以工具形式開放，你既可以通過編程手段，也能借助如 Claude Desktop 這類大語言模型，實現對護欄（涵蓋所有策略類型）的創建、編輯、刪除和導出操作。同時，它還支持將護欄配置導出為 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
   

💻 使用示例

基礎用法

與 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 工具，將所有必需和可選的策略配置作為字典傳遞。
• 更新護欄：使用 update_guardrail_full 並提供護欄 ID 和要更新的任何字段。
• 導出為 Terraform：使用 export_guardrail_to_terraform(guardrail_id) 為你的護欄獲取一個 .tf 資源塊。

📚 詳細文檔

影響與用例

• 企業大語言模型安全：集中管理和自動化所有生成式 AI 應用的 Bedrock Guardrails。
• DevOps 與基礎設施即代碼：將護欄導出到 Terraform 以進行版本控制、可重複性和 CI/CD 集成。
• 大語言模型工具：使大語言模型（如 Claude）能夠以編程方式管理安全策略、審計和修復風險。

安全說明

• 憑證僅從環境變量中讀取，不會存儲在代碼或日誌中。
• 所有 AWS API 調用均使用官方 boto3 SDK 進行。

📄 許可證

請參閱 LICENSE 文件。