亚马逊 Bedrock MCP 服务器

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

特性

• 使用 Amazon 的 Nova Canvas 模型从文本描述生成高质量图像
• 通过负面提示（negative prompt）进行高级控制，优化图像构图
• 灵活的配置选项，支持自定义图像尺寸和质量
• 支持种子值控制，确保生成过程可重复
• 强大的输入验证和错误处理机制

先决条件

1. 拥有有效 AWS 账户，具备 Amazon Bedrock 和 Nova Canvas 模型访问权限
2. 正确配置的 AWS 凭证，具有相应的 Bedrock 权限
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": "执行命令",
      "args": []
    }
  }
}

可用工具

generate_image 函数参数

• Bucket: 存储图像的 S3 存储桶名称（必需）
• ObjectKey: 图像在存储桶中的键名（必需）
• Prompt: 图像生成的文本描述（必需）
• NegativePrompt: 用于排除的内容提示
• Width: 图像宽度（默认 512）
• Height: 图像高度（默认 512）
• Quality: 生成质量，取值范围 0 到 100（默认 100）
• SamplingSteps: 采样步骤数（默认 20）
• SafetyThreshold: 安全阈值，控制生成内容的保守程度
• Seed: 随机种子值，确保可重复性

示例代码

const { generateImage } = require('@your-package');

async function main() {
    const response = await generateImage({
        bucket: 'my-image-bucket',
        objectKey: 'generated-image.png',
        prompt: '一只飞翔的蓝鸟',
        negativePrompt: 'low quality, blurry',
        width: 800,
        height: 600,
        quality: 100
    });
    
    console.log('图像生成完成');
}

开发指南

克隆仓库

git clone https://github.com/your-repository.git
cd your-repository

安装依赖项

npm install

构建项目

npm run build

性能考虑

图像生成时间受分辨率、数量和质量设置影响。请在实现中注意潜在的超时问题。

许可证

本项目遵循 MIT 许可证，具体内容详见 LICENSE 文件。