Amazon Bedrock MCP 服务器

一个与 Amazon Bedrock 的 Nova Canvas 模型集成的模型控制协议 (MCP) 服务器，用于 AI 图像生成。

功能

• 使用 Amazon 的 Nova Canvas 模型从文本描述中生成高质量图像
• 通过否定提示进行高级控制以优化图像组成
• 灵活的配置选项，包括图像尺寸和质量
• 通过种子控制实现确定性图像生成
• 强大的输入验证和错误处理

前提条件

1. 拥有可访问 Amazon Bedrock 和 Nova Canvas 模型的活跃 AWS 账户
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",         // Optional, only if you want to use a specific profile
        "AWS_ACCESS_KEY_ID": "your_access_key",     // Optional if using AWS credentials file or IAM role
        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // Optional if using AWS credentials file or IAM role
        "AWS_REGION": "us-east-1"                   // Optional, defaults to 'us-east-1'
      }
    }
  }
}

可用工具

generate_image

使用 Amazon Bedrock 的 Nova Canvas 模型从文本描述中创建图像。

参数

• prompt (必需): 所需图像的描述性文本 (1-1024 个字符)
• negativePrompt (可选): 要从图像中排除的元素 (1-1024 个字符)
• width (可选): 图像宽度（像素）(默认: 1024)
• height (可选): 图像高度（像素）(默认: 1024)
• quality (可选): 图像质量级别 - "standard" 或 "premium" (默认: "standard")
• cfg_scale (可选): 提示遵循强度 (1.1-10, 默认: 6.5)
• seed (可选): 用于重现性的生成种子 (0-858993459, 默认: 12)
• numberOfImages (可选): 生成批次大小 (1-5, 默认: 1)

示例实现

const result = await callTool('generate_image', {
  prompt: "A serene mountain landscape at sunset",
  negativePrompt: "people, buildings, vehicles",
  quality: "premium",
  cfg_scale: 8,
  numberOfImages: 2
});

提示指南

为了获得最佳效果，请避免在主提示中使用否定措辞（如“无”、“不”、“没有”）。相反，将这些元素移到 negativePrompt 参数中。例如，不要在提示中使用“没有建筑物的风景”，而是将“建筑物”放在 negativePrompt 中。

有关详细的使用指南，请参阅Nova Canvas 文档。

开发

要在本地环境中设置并运行服务器：

git clone https://github.com/zxkane/mcp-server-amazon-bedrock.git
cd mcp-server-amazon-bedrock
npm install
npm run build

性能考虑

生成时间受分辨率（width 和 height）、numberOfImages 以及 quality 设置的影响。当使用较高值时，请注意在您的实现中可能会出现的超时问题。

许可证

本项目采用 MIT 许可证 - 详情请参见 LICENSE 文件。