What is Mcp Server Amazon Bedrock

mcp-server-amazon-bedrock is a Model Control Protocol (MCP) server designed to integrate with Amazon Bedrock’s Nova Canvas model for generating high-quality images from text descriptions.

Use cases

Use cases for mcp-server-amazon-bedrock include generating artwork, creating visual content for marketing, and producing images for educational materials based on textual descriptions.

How to use

To use mcp-server-amazon-bedrock, set up your AWS credentials, configure the server, and call the ‘generate_image’ tool with the required parameters to create images based on your text prompts.

Key features

Key features include high-quality image generation, advanced control through negative prompts, flexible configuration options for image dimensions and quality, deterministic image generation with seed control, and robust input validation.

Where to use

undefined

Amazon Bedrock MCP Server

A Model Control Protocol (MCP) server that integrates with Amazon Bedrock’s Nova Canvas model for AI image generation.

Features

• High-quality image generation from text descriptions using Amazon’s Nova Canvas model
• Advanced control through negative prompts to refine image composition
• Flexible configuration options for image dimensions and quality
• Deterministic image generation with seed control
• Robust input validation and error handling

Prerequisites

1. Active AWS account with Amazon Bedrock and Nova Canvas model access
2. Properly configured AWS credentials with required permissions
3. Node.js version 18 or later

Installation

AWS Credentials Configuration

The server requires AWS credentials with appropriate Amazon Bedrock permissions. Configure these using one 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 preferred region
   

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

   [the_profile_name]
   aws_access_key_id = your_access_key
   aws_secret_access_key = your_secret_key
   

   Environment variable for active profile:

   export AWS_PROFILE=the_profile_name
   

3. IAM role (when deployed 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

Available Tools

generate_image

Creates images from text descriptions using Amazon Bedrock’s Nova Canvas model.

Parameters

• prompt (required): Descriptive text for the desired image (1-1024 characters)
• negativePrompt (optional): Elements to exclude from the image (1-1024 characters)
• width (optional): Image width in pixels (default: 1024)
• height (optional): Image height in pixels (default: 1024)
• quality (optional): Image quality level - “standard” or “premium” (default: “standard”)
• cfg_scale (optional): Prompt adherence strength (1.1-10, default: 6.5)
• seed (optional): Generation seed for reproducibility (0-858993459, default: 12)
• numberOfImages (optional): Batch size for generation (1-5, default: 1)

Example Implementation

const result = await callTool('generate_image', {
  prompt: "A serene mountain landscape at sunset",
  negativePrompt: "people, buildings, vehicles",
  quality: "premium",
  cfg_scale: 8,
  numberOfImages: 2
});

Prompt Guidelines

For optimal results, avoid negative phrasing (“no”, “not”, “without”) in the main prompt. Instead, move these elements to the negativePrompt parameter. For example, rather than using “a landscape without buildings” in the prompt, use “buildings” in the negativePrompt.

For detailed usage guidelines, refer to the Nova Canvas documentation.

Development

To set up and run the server in a local environment:

git clone https://github.com/zxkane/mcp-server-amazon-bedrock.git
cd mcp-server-amazon-bedrock
npm install
npm run build

Performance Considerations

Generation time is influenced by resolution (width and height), numberOfImages, and quality settings. When using higher values, be mindful of potential timeout implications in your implementation.

License

This project is licensed under the MIT License - see the LICENSE file for details.