Amazon Bedrock MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/zxkane-mcp-server-amazon-bedrock-badge.png)](https://mseep.ai/app/zxkane-mcp-server-amazon-bedrock)
2 
3# Amazon Bedrock MCP Server
4 
5A Model Control Protocol (MCP) server that integrates with Amazon Bedrock's Nova Canvas model for AI image generation.
6 
7<a href="https://glama.ai/mcp/servers/9qw7dwpvj9"><img width="380" height="200" src="https://glama.ai/mcp/servers/9qw7dwpvj9/badge" alt="Amazon Bedrock Server MCP server" /></a>
8 
9## Features
10 
11- High-quality image generation from text descriptions using Amazon's Nova Canvas model
12- Advanced control through negative prompts to refine image composition
13- Flexible configuration options for image dimensions and quality
14- Deterministic image generation with seed control
15- Robust input validation and error handling
16 
17## Prerequisites
18 
191. Active AWS account with Amazon Bedrock and Nova Canvas model access
202. Properly configured AWS credentials with required permissions
213. Node.js version 18 or later
22 
23## Installation
24 
25### AWS Credentials Configuration
26 
27The server requires AWS credentials with appropriate Amazon Bedrock permissions. Configure these using one of the following methods:
28 
291. Environment variables:
30   ```bash
31   export AWS_ACCESS_KEY_ID=your_access_key
32   export AWS_SECRET_ACCESS_KEY=your_secret_key
33   export AWS_REGION=us-east-1  # or your preferred region
34   ```
35 
362. AWS credentials file (`~/.aws/credentials`):
37   ```ini
38   [the_profile_name]
39   aws_access_key_id = your_access_key
40   aws_secret_access_key = your_secret_key
41   ```
42   Environment variable for active profile:
43   ```bash
44   export AWS_PROFILE=the_profile_name
45   ```
46 
473. IAM role (when deployed on AWS infrastructure)
48 
49### Claude Desktop Integration
50 
51To integrate with Claude Desktop, add the following configuration to your settings file:
52 
53MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
54Windows: `%APPDATA%/Claude/claude_desktop_config.json`
55 
56```json
57{
58  "mcpServers": {
59    "amazon-bedrock": {
60      "command": "npx",
61      "args": [
62        "-y",
63        "@zxkane/mcp-server-amazon-bedrock"
64      ],
65      "env": {
66        "AWS_PROFILE": "your_profile_name",         // Optional, only if you want to use a specific profile
67        "AWS_ACCESS_KEY_ID": "your_access_key",     // Optional if using AWS credentials file or IAM role
68        "AWS_SECRET_ACCESS_KEY": "your_secret_key", // Optional if using AWS credentials file or IAM role
69        "AWS_REGION": "us-east-1"                   // Optional, defaults to 'us-east-1'
70      }
71    }
72  }
73}
74```
75 
76## Available Tools
77 
78### generate_image
79 
80Creates images from text descriptions using Amazon Bedrock's Nova Canvas model.
81 
82#### Parameters
83 
84- `prompt` (required): Descriptive text for the desired image (1-1024 characters)
85- `negativePrompt` (optional): Elements to exclude from the image (1-1024 characters)
86- `width` (optional): Image width in pixels (default: 1024)
87- `height` (optional): Image height in pixels (default: 1024)
88- `quality` (optional): Image quality level - "standard" or "premium" (default: "standard")
89- `cfg_scale` (optional): Prompt adherence strength (1.1-10, default: 6.5)
90- `seed` (optional): Generation seed for reproducibility (0-858993459, default: 12)
91- `numberOfImages` (optional): Batch size for generation (1-5, default: 1)
92 
93#### Example Implementation
94 
95```typescript
96const result = await callTool('generate_image', {
97  prompt: "A serene mountain landscape at sunset",
98  negativePrompt: "people, buildings, vehicles",
99  quality: "premium",
100  cfg_scale: 8,
101  numberOfImages: 2
102});
103```
104 
105#### Prompt Guidelines
106 
107For 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`.
108 
109For detailed usage guidelines, refer to the [Nova Canvas documentation][nova-canvas-doc].
110 
111## Development
112 
113To set up and run the server in a local environment:
114 
115```bash
116git clone https://github.com/zxkane/mcp-server-amazon-bedrock.git
117cd mcp-server-amazon-bedrock
118npm install
119npm run build
120```
121 
122### Performance Considerations
123 
124Generation 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.
125 
126## License
127 
128This project is licensed under the MIT License - see the LICENSE file for details.
129 
130[nova-canvas-doc]: https://docs.aws.amazon.com/nova/latest/userguide/image-gen-access.html
131