https://github.com/zxkane/mcp-server-amazon-bedrock
Model Context Procotol(MCP) server for using Amazon Bedrock Nova Canvas to generate images
https://github.com/zxkane/mcp-server-amazon-bedrock
amazon-bedrock amazon-nova claude model-context-protocol
Last synced: 1 day ago
JSON representation
Model Context Procotol(MCP) server for using Amazon Bedrock Nova Canvas to generate images
- Host: GitHub
- URL: https://github.com/zxkane/mcp-server-amazon-bedrock
- Owner: zxkane
- License: mit
- Created: 2024-12-25T08:47:08.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-27T07:20:47.000Z (4 months ago)
- Last Synced: 2025-04-12T08:14:30.980Z (4 days ago)
- Topics: amazon-bedrock, amazon-nova, claude, model-context-protocol
- Language: JavaScript
- Homepage:
- Size: 45.9 KB
- Stars: 19
- Watchers: 2
- Forks: 9
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Amazon Bedrock Nova Canvas - Use Amazon Nova Canvas model for image generation. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - Amazon Bedrock Nova Canvas - Use Amazon Nova Canvas model for image generation. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
- awesome-mcp-servers - Amazon Bedrock Nova Canvas - Model Context Procotol(MCP) server for using Amazon Bedrock Nova Canvas to generate images (Table of Contents / AI Services)
README
# 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:
```bash
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`):
```ini
[the_profile_name]
aws_access_key_id = your_access_key
aws_secret_access_key = your_secret_key
```
Environment variable for active profile:
```bash
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`
```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'
}
}
}
}
```
## 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
```typescript
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][nova-canvas-doc].
## Development
To set up and run the server in a local environment:
```bash
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.
[nova-canvas-doc]: https://docs.aws.amazon.com/nova/latest/userguide/image-gen-access.html