Amazon Bedrock MCP Server

Amazon Bedrock MCP 服务

一个与 Amazon Bedrock 的 Nova Canvas 模型集成、用于 AI 图像生成的 Model Control Protocol (MCP) 服务。

功能

• 使用 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  # or your preferred region
   

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
});

提示词指南

为获得最佳效果，请避免在主提示词中使用否定表述（"no"、"not"、"without"）。而应将这些元素移到 negativePrompt 参数中。例如，不要在提示词中使用 "a landscape without buildings"，而应在 negativePrompt 中使用 "buildings"。

有关详细的使用指南，请参阅 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 文件。