Zxkane MCP Server Amazon Bedrock

🚀 亞馬遜 Bedrock MCP 服務器

這是一個集成了 Amazon Bedrock 的 Nova Canvas 模型的模型控制協議（MCP）服務器，專門用於 AI 圖像生成。通過它，用戶能夠基於文本描述生成高質量的圖像。

✨ 主要特性

• 藉助 Amazon 的 Nova Canvas 模型，可根據文本描述生成高質量圖像。
• 具備高級控制能力，能通過負面提示優化圖像構圖。
• 提供靈活的配置選項，支持自定義圖像尺寸和質量。
• 可利用種子值實現確定性的圖像生成。
• 擁有強大的輸入驗證和錯誤處理機制。

📦 安裝指南

先決條件

1. 需擁有有效 AWS 賬戶，並具備 Amazon Bedrock 和 Nova Canvas 模型訪問權限。
2. 要正確配置具有所需權限的 AWS 憑證。
3. 需安裝 Node.js 版本 18 或更高版本。

AWS 憑證配置

服務器需要具備 Amazon Bedrock 權限的 AWS 憑證，可通過以下任一方法配置：

1. 環境變量：

   export AWS_ACCESS_KEY_ID=your_access_key
   export AWS_SECRET_ACCESS_KEY=your_secret_key
   export AWS_REGION=us-east-1  # 或您選擇的區域
   

2. AWS 憑證文件 (~/.aws/credentials)：

   [the_profile_name]
   aws_access_key_id = your_access_key
   aws_secret_access_key = your_secret_key
   

   可通過環境變量指定活動配置文件：

   export AWS_PROFILE=the_profile_name
   

3. IAM 角色（當部署在 AWS 基礎設施上時）

Claude Desktop 集成

若要在 Claude Desktop 中集成，需將以下配置添加到您的設置文件中：

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazon-bedrock": {
      "command": "npx",
      "args": [
        "-y",
        "@zxkane/mcp-server-amazon-bedrock"
      ],
      "env": {
        "AWS_PROFILE": "your_profile_name",         // 可選，如果您想使用特定配置文件
        "AWS_ACCESS_KEY_ID": "your_access_key",     // 可選，僅在您未使用 AWS 憑證文件或 IAM 角色時
        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // 可選，僅在您未使用 AWS 淨文件或 IAM role 時
        "AWS_REGION": "us-east-1"                   // 可選，默認為 'us-east-1'
      }
    }
  }
}

💻 使用示例

generate_image

這是一個從文本描述生成圖像的工具，支持自定義尺寸、格式和負面提示。

參數說明

代碼示例

# 基礎用法
generate_image --prompt "一隻坐在月光下的貓" --width 1024 --height 768

# 高級用法
# 使用負面提示和自定義參數
generate_image --prompt "一隻坐在月光下的貓" --negative_prompt "狗, 灰暗的環境" --width 1024 --height 768 --samples 2 --seed 123

📚 詳細文檔

開發指南

克隆倉庫

使用 Git 克隆此項目：

git clone https://github.com/yourusername/mcp-bedrock.git
cd mcp-bedrock

安裝依賴

安裝項目所需的依賴包：

npm install

運行服務器

啟動 MCP 服務器：

node index.js

🔧 技術細節

生成圖像可能會佔用較多資源，建議在高性能計算環境中運行。同時，請注意調整參數以避免過長的推理時間。

📄 許可證

本項目採用 MIT 許可證，具體內容請查閱 LICENSE 文件。