使用说明

项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，专注于利用 Amazon Bedrock 的 Nova Canvas 模型进行 AI 图像生成。它允许用户通过 MCP 协议，使用文本描述来生成高质量的图像。作为一个 MCP 服务器，它可以与任何兼容 MCP 协议的客户端协同工作，例如 Claude Desktop 等应用。

主要功能点

文本生成图像: 核心功能是根据用户提供的文本提示（prompt），使用 Amazon Nova Canvas 模型生成图像。
丰富的图像生成参数: 支持多种参数配置，包括：
- 'prompt': 生成图像的文本描述。
- 'negativePrompt': 指定不希望出现在图像中的元素，以优化生成效果。
- 'width', 'height': 图像的宽度和高度，可自定义图像尺寸。
- 'quality': 图像质量选择，支持 "standard" 和 "premium" 两种模式。
- 'cfg_scale': prompt 遵循度，控制生成图像与 prompt 的相关性。
- 'seed': 随机种子，用于实现可重复的图像生成结果。
- 'numberOfImages': 一次性生成的图像数量。
输入参数校验: 对所有输入参数进行严格校验，确保符合 Nova Canvas 模型的要求，并提供清晰的错误提示。
MCP 标准协议: 完全遵循 MCP 协议规范，易于集成到任何支持 MCP 协议的客户端应用中。
Claude Desktop 集成指南: 提供详细的 Claude Desktop 客户端集成配置方法。

安装步骤

环境准备: 确保已安装 Node.js (版本 18 或更高) 和 npm 包管理器。
AWS 账户和权限配置:
- 拥有有效的 AWS 账户，并已开通 Amazon Bedrock 服务以及 Nova Canvas 模型的访问权限。
- 配置 AWS 认证信息。可以通过以下方式之一进行配置：
  - 环境变量: 设置 'AWS_ACCESS_KEY_ID', 'AWS_SECRET_ACCESS_KEY', 和 'AWS_REGION' 环境变量。
  - AWS 凭证文件: 在 '~/.aws/credentials' 文件中配置 AWS 凭证，并设置 'AWS_PROFILE' 环境变量指定使用的 profile。
  - IAM 角色: 如果服务器部署在 AWS 环境中，可以配置 IAM 角色。
下载仓库: 使用 'git clone https://github.com/zxkane/mcp-server-amazon-bedrock.git' 命令下载仓库代码。
安装依赖: 进入仓库目录，运行 'npm install' 命令安装项目依赖。
构建项目: 运行 'npm run build' 命令编译 TypeScript 代码。

服务器配置

此 MCP 服务器设计为与 MCP 客户端协同工作。要配置客户端（例如 Claude Desktop）连接到此服务器，您需要提供服务器的启动命令和相关参数。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例：

{
  "mcpServers": {
    "amazon-bedrock": {
      "command": "npx",
      "args": [
        "-y",
        "@zxkane/mcp-server-amazon-bedrock"
      ],
      "env": {
        // "AWS_PROFILE": "your_profile_name",         // (可选) 如果您希望使用特定的 AWS profile，取消注释并替换为您的 profile 名称
        // "AWS_ACCESS_KEY_ID": "your_access_key",     // (可选) 仅当您不使用 AWS 凭证文件或 IAM 角色时需要
        // "AWS_SECRET_ACCESS_KEY": "your_secret_key", // (可选) 仅当您不使用 AWS 凭证文件或 IAM 角色时需要
        // "AWS_REGION": "us-east-1"                   // (可选) AWS 区域，默认为 'us-east-1'，您可以根据需要修改
      }
    }
  }
}

配置项说明:

'"command": "npx"': 指定启动命令为 'npx'，用于执行 npm 包。
'"args": ["-y", "@zxkane/mcp-server-amazon-bedrock"]': 'npx' 命令的参数，'-y' 表示自动确认安装包，'@zxkane/mcp-server-amazon-bedrock' 是要执行的 npm 包名称。
'"env": { ... }': (可选) 环境变量配置，您可以在这里配置 AWS 相关的环境变量，例如 AWS 凭证和区域。如果您的 AWS 凭证已通过其他方式配置（如环境变量、凭证文件或 IAM 角色），则可以省略 'env' 部分的配置。

基本使用方法

启动 MCP 服务器: 在完成安装和配置后，当 MCP 客户端（如 Claude Desktop）启动时，会自动根据配置连接到此 MCP 服务器。您也可以在本地仓库目录下，运行 'npm run start' 命令手动启动服务器。
使用 'generate_image' 工具: 在 MCP 客户端中，您可以使用 'generate_image' 工具来生成图像。例如，在 Claude Desktop 中，您可以使用类似 '@generate_image' 命令，并提供相应的参数，示例如下：
```
@generate_image prompt="未来城市日落景色" negativePrompt="人群" quality="premium"
```
服务器接收到请求后，将调用 Amazon Bedrock Nova Canvas 模型生成符合描述的图像，并将生成的图像数据返回给客户端。

关键词