Zxkane MCP Server Amazon Bedrock

🚀 Amazon Bedrock MCP Server

An MCP (Model Control Protocol) server integrating Amazon Bedrock's Nova Canvas model for AI image generation.

✨ Features

• Generate high-quality images from text descriptions using Amazon's Nova Canvas model.
• Advanced control for refining image composition through negative prompts.
• Flexible configuration options supporting custom image sizes and quality.
• Use seed values for deterministic image generation.
• Robust input validation and error handling mechanisms.

📦 Prerequisites

1. An active AWS account with access to Amazon Bedrock and the Nova Canvas model.
2. Properly configured AWS credentials with the required permissions.
3. Node.js version 18 or higher installed.

📦 Installation Guide

AWS Credential Configuration

The server requires AWS credentials with Amazon Bedrock permissions. You can configure them using any of the following methods:

1. Environment variables:

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=us-east-1  # Or your chosen region

2. AWS credential file (~/.aws/credentials):

[the_profile_name]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key

Set the environment variable to specify the active profile:

export AWS_PROFILE=the_profile_name

3. IAM role (when deploying on AWS infrastructure).

Claude Desktop Integration

To integrate with Claude Desktop, add the following configuration to your settings file:

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, if you want to use a specific profile
        "AWS_ACCESS_KEY_ID": "your_access_key",     // Optional, only if you're not using an AWS credential file or IAM role
        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // Optional, only if you're not using an AWS credential file or IAM role
        "AWS_REGION": "us-east-1"                   // Optional, default is 'us-east-1'
      }
    }
  }
}

💻 Usage Examples

generate_image

A tool for generating images from text descriptions, supporting custom sizes, formats, and negative prompts.

Parameter Explanation

Examples

# Basic usage
generate_image --prompt "A cat sitting under the moonlight" --width 1024 --height 768

# Use negative prompts and custom parameters
generate_image --prompt "A cat sitting under the moonlight" --negative_prompt "Dogs, dull environment" --width 1024 --height 768 --samples 2 --seed 123

📚 Documentation

Clone the Repository

Clone this project using Git:

git clone https://github.com/yourusername/mcp-bedrock.git
cd mcp-bedrock

Install Dependencies

Install the required dependencies for the project:

npm install

Run the Server

Start the MCP server:

node index.js

🔧 Technical Details

Generating images can be resource-intensive. It is recommended to run this in a high-performance computing environment. Also, adjust the parameters to avoid excessively long inference times.

📄 License

This project is licensed under the MIT license. Please refer to the LICENSE file for details.