AI图像生成服务器

一个与Amazon Bedrock的Nova Canvas模型集成的AI图像生成服务器,支持通过文本描述生成高质量图像,并提供高级控制选项。

  • by zxkane
  • JavaScript
  • 本地部署
  • 25 星标
  • 更新于
在 GitHub 查看 zxkane/mcp-server-amazon-bedrock

使用说明

亚马逊基岩MCP服务器

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

特性

  • 使用亚马逊的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桌面集成

要与Claude Desktop集成,请将以下配置添加到您的设置文件中:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 窗户: %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 (可选):图像质量级别-“标准”或“高级”(默认:“标准”)
  • 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许可证获得许可-有关详细信息,请参阅许可证文件。