Amazon Bedrock MCP Server

Amazon Bedrock MCP Server

Model Control Protocol server for AI image generation via Amazon Bedrock's Nova Canvas.

22
Stars
12
Forks
22
Watchers
1
Issues
Amazon Bedrock MCP Server implements the Model Control Protocol to enable advanced AI image generation using Amazon's Nova Canvas model. It provides features like deterministic output through seed control, negative prompts, and configurable quality and image dimensions. Secure and flexible AWS credential management is supported, along with integration for Claude Desktop and robust input validation. The solution ensures high-quality, reproducible image generation workflows tailored for both developers and integrated applications.

Key Features

Model Control Protocol (MCP) compliant server
Integration with Amazon Bedrock Nova Canvas
Negative prompt support for refined image creation
Customizable image dimensions and quality
Deterministic image generation via seed parameter
Robust AWS credentials and permissions handling
Batch image generation (multiple images per request)
Input validation and error handling
Easy integration with Claude Desktop
Comprehensive configuration options

Use Cases

AI-powered image generation from textual prompts
Automated batch creation of visual assets for design workflows
Generating high-quality, reproducible images for content creation
Building custom image generation tools integrated with AWS services
Desktop integration for creative professionals using Claude Desktop
Rapid prototyping of image-based ideas with fine-tuned parameters
Controlling output style and composition through advanced prompts
Enabling deterministic content for version-controlled assets
Educational purposes for learning AI image generation systems
Enhancing product visuals and marketing materials using AI

README

MseeP.ai Security Assessment Badge

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.

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.

Star History

Star History Chart

Repository Owner

zxkane
zxkane

User

Repository Details

Language JavaScript
Default Branch main
Size 48 KB
Contributors 3
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
76.75%
TypeScript
23.25%

Tags

Topics

amazon-bedrock amazon-nova claude model-context-protocol

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • @nanana-ai/mcp-server-nano-banana

    @nanana-ai/mcp-server-nano-banana

    MCP server for Nanana AI image generation using Gemini's nano banana model.

    @nanana-ai/mcp-server-nano-banana serves as an MCP (Model Context Protocol) compatible server for facilitating image generation and transformation powered by the Gemini nano banana model. It enables clients like Claude Desktop to interact with Nanana AI, processing text prompts to generate images or transform existing images. The server can be easily configured with API tokens and integrated into desktop applications. Users can manage credentials, customize endpoints, and monitor credit usage seamlessly.

    • 3
    • MCP
    • nanana-app/mcp-server-nano-banana
  • piapi-mcp-server

    piapi-mcp-server

    TypeScript-based MCP server for PiAPI media content generation

    piapi-mcp-server is a TypeScript implementation of a Model Context Protocol (MCP) server that connects with PiAPI to enable media generation workflows from MCP-compatible applications. It handles image, video, music, TTS, 3D, and voice generation tasks using a wide range of supported models like Midjourney, Flux, Kling, LumaLabs, Udio, and more. Designed for easy integration with clients such as Claude Desktop, it includes an interactive MCP Inspector for development, testing, and debugging.

    • 62
    • MCP
    • apinetwork/piapi-mcp-server
  • Replicate Flux MCP

    Replicate Flux MCP

    MCP-compatible server for high-quality image and SVG generation via Replicate models.

    Replicate Flux MCP is an advanced Model Context Protocol (MCP) server designed to enable AI assistants to generate high-quality raster images and vector graphics. It leverages Replicate's Flux Schnell model for image synthesis and Recraft V3 SVG model for vector output, supporting seamless integration with AI platforms like Cursor, Claude Desktop, Smithery, and Glama.ai. Users can generate images and SVGs by simply providing natural language prompts, with support for parameter customization, batch processing, and variant creation.

    • 66
    • MCP
    • awkoy/replicate-flux-mcp
  • Make MCP Server (legacy)

    Make MCP Server (legacy)

    Enable AI assistants to utilize Make automation workflows as callable tools.

    Make MCP Server (legacy) provides a Model Context Protocol (MCP) server that connects AI assistants with Make scenarios configured for on-demand execution. It parses and exposes scenario parameters, allowing AI systems to invoke automation workflows and receive structured JSON outputs. The server supports secure integration through API keys and facilitates seamless communication between AI and Make's automation platform.

    • 142
    • MCP
    • integromat/make-mcp-server
  • Unichat MCP Server

    Unichat MCP Server

    Universal MCP server providing context-aware AI chat and code tools across major model vendors.

    Unichat MCP Server enables sending standardized requests to leading AI model vendors, including OpenAI, MistralAI, Anthropic, xAI, Google AI, DeepSeek, Alibaba, and Inception, utilizing the Model Context Protocol. It features unified endpoints for chat interactions and provides specialized tools for code review, documentation generation, code explanation, and programmatic code reworking. The server is designed for seamless integration with platforms like Claude Desktop and installation via Smithery. Vendor API keys are required for secure access to supported providers.

    • 37
    • MCP
    • amidabuddha/unichat-mcp-server
  • Yuque-MCP-Server

    Yuque-MCP-Server

    Seamless integration of Yuque knowledge base with Model-Context-Protocol for AI model context management.

    Yuque-MCP-Server provides an MCP-compatible server for interacting with the Yuque knowledge base platform. It enables AI models to retrieve, manage, and analyze Yuque documents and user information through a standardized Model-Context-Protocol interface. The server supports operations such as document creation, reading, updating, deletion, advanced search, and team statistics retrieval, making it ideal for AI-powered workflows. Inspired by Figma-Context-MCP, it facilitates contextual awareness and dynamic knowledge management for AI applications.

    • 31
    • MCP
    • HenryHaoson/Yuque-MCP-Server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results