awslabs.nova-canvas-mcp-server 0.1.10233

An AWS Labs Model Context Protocol (MCP) server for Amazon Nova Canvas

awslabs MCP Nova Canvas Server

MCP server for generating images using Amazon Nova Canvas

Features

• Text-based image generation - Create images from text prompts with generate_image

  • Customizable dimensions (320-4096px), quality options, and negative prompting
  • Supports multiple image generation (1-5) in single request
  • Adjustable parameters like cfg_scale (1.1-10.0) and seeded generation

• Color-guided image generation - Generate images with specific color palettes using generate_image_with_colors

  • Define up to 10 hex color values to influence the image style and mood
  • Same customization options as text-based generation

• Workspace integration - Images saved to user-specified workspace directories with automatic folder creation

• AWS authentication - Uses AWS profiles for secure access to Amazon Nova Canvas services

Prerequisites

1. Install uv from Astral or the GitHub README
2. Install Python using uv python install 3.13
3. Set up AWS credentials with access to Amazon Bedrock and Nova Canvas
   • You need an AWS account with Amazon Bedrock and Amazon Nova Canvas enabled
   • Configure AWS credentials with aws configure or environment variables
   • Ensure your IAM role/user has permissions to use Amazon Bedrock and Nova Canvas

Installation

Install the MCP server:

Add the server to your MCP client config (e.g. for Amazon Q CLI MCP, ~/.aws/amazonq/mcp.json):

{
  "mcpServers": {
    "awslabs.nova-canvas-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.nova-canvas-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",  // Optional: specify AWS profile
        "AWS_REGION": "us-east-1"           // Required: region where Bedrock is available
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

AWS Authentication

The MCP server uses the AWS profile specified in the AWS_PROFILE environment variable. If not provided, it defaults to the "default" profile in your AWS configuration file.

"env": {
  "AWS_PROFILE": "your-aws-profile",  // Specify which AWS profile to use
  "AWS_REGION": "us-east-1"           // Region where Bedrock is available
}

Make sure the AWS profile has permissions to access Amazon Bedrock and Amazon Nova Canvas. The MCP server creates a boto3 session using the specified profile to authenticate with AWS services. Your AWS IAM credentials remain on your local machine and are strictly used for using the Amazon Bedrock model APIs.