Skip to main content
Glama
AWS Nova Canvas

AWS Nova Canvas

Official
by awslabs

Amazon Nova Canvas MCP 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

Related MCP server: MCP Media Generator

Prerequisites

  1. Install uv from Astral or the GitHub README

  2. Install Python using uv python install 3.10

  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

Kiro

Cursor

VS Code

Add to Kiro

Install MCP Server

Install on VS Code

Configure the MCP server in your MCP client configuration (e.g., for Kiro, edit ~/.kiro/settings/mcp.json):

{
  "mcpServers": {
    "awslabs.nova-canvas-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.nova-canvas-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Windows Installation

For Windows users, the MCP server configuration format is slightly different:

{
  "mcpServers": {
    "awslabs.nova-canvas-mcp-server": {
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "--from",
        "awslabs.nova-canvas-mcp-server@latest",
        "awslabs.nova-canvas-mcp-server.exe"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "ERROR",
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1"
      }
    }
  }
}

or docker after a successful docker build -t awslabs/nova-canvas-mcp-server .:

# fictitious `.env` file with AWS temporary credentials
AWS_ACCESS_KEY_ID=ASIAIOSFODNN7EXAMPLE
AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
AWS_SESSION_TOKEN=AQoEXAMPLEH4aoAH0gNCAPy...truncated...zrkuWJOgQs8IZZaIv2BXIa2R4Olgk
  {
    "mcpServers": {
      "awslabs.nova-canvas-mcp-server": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "--interactive",
          "--env",
          "AWS_REGION=us-east-1",
          "--env",
          "FASTMCP_LOG_LEVEL=ERROR",
          "--env-file",
          "/full/path/to/file/above/.env",
          "awslabs/nova-canvas-mcp-server:latest"
        ],
        "env": {},
        "disabled": false,
        "autoApprove": []
      }
    }
  }

NOTE: Your credentials will need to be kept refreshed from your host

Installing via Smithery

To install Amazon Nova Canvas MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @awslabs/nova-canvas-mcp-server --client claude

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",
  "AWS_REGION": "us-east-1"
}

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.

Available Tools

2 tools
generate_imageA

Generate an image using Amazon Nova Canvas with text prompt.

This tool uses Amazon Nova Canvas to generate images based on a text prompt.
The generated image will be saved to a file and the path will be returned.

IMPORTANT FOR ASSISTANT: Always send the current workspace directory when calling this tool!
The workspace_dir parameter should be set to the directory where the user is currently working
so that images are saved to a location accessible to the user.

## Prompt Best Practices

An effective prompt often includes short descriptions of:
1. The subject
2. The environment
3. (optional) The position or pose of the subject
4. (optional) Lighting description
5. (optional) Camera position/framing
6. (optional) The visual style or medium ("photo", "illustration", "painting", etc.)

Do not use negation words like "no", "not", "without" in your prompt. Instead, use the
negative_prompt parameter to specify what you don't want in the image.

You should always include "people, anatomy, hands, low quality, low resolution, low detail" in your negative_prompt

## Example Prompts

- "realistic editorial photo of female teacher standing at a blackboard with a warm smile"
- "whimsical and ethereal soft-shaded story illustration: A woman in a large hat stands at the ship's railing looking out across the ocean"
- "drone view of a dark river winding through a stark Iceland landscape, cinematic quality"

Returns:
    McpImageGenerationResponse: A response containing the generated image paths.

Inputs: prompt (required), negative_prompt, filename, width, +6 more. Returns: Response from image generation API. This model represents the response from the…

generate_image_with_colorsA

Generate an image using Amazon Nova Canvas with color guidance.

This tool uses Amazon Nova Canvas to generate images based on a text prompt and color palette.
The generated image will be saved to a file and the path will be returned.

IMPORTANT FOR Assistant: Always send the current workspace directory when calling this tool!
The workspace_dir parameter should be set to the directory where the user is currently working
so that images are saved to a location accessible to the user.

## Prompt Best Practices

An effective prompt often includes short descriptions of:
1. The subject
2. The environment
3. (optional) The position or pose of the subject
4. (optional) Lighting description
5. (optional) Camera position/framing
6. (optional) The visual style or medium ("photo", "illustration", "painting", etc.)

Do not use negation words like "no", "not", "without" in your prompt. Instead, use the
negative_prompt parameter to specify what you don't want in the image.

## Example Colors

- ["#FF5733", "#33FF57", "#3357FF"] - A vibrant color scheme with red, green, and blue
- ["#000000", "#FFFFFF"] - A high contrast black and white scheme
- ["#FFD700", "#B87333"] - A gold and bronze color scheme

Returns:
    McpImageGenerationResponse: A response containing the generated image paths.

Inputs: prompt (required), colors (required), negative_prompt, filename, +7 more. Returns: Response from image generation API. This model represents the response from the…

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation2/5

    The two tools have significant overlap in purpose and functionality. Both generate images using Amazon Nova Canvas with text prompts, and both require workspace directory parameters. The only distinction is that 'generate_image_with_colors' adds color palette guidance, which could be handled as an optional parameter in a single tool. This overlap creates ambiguity about when to use each tool.

    Naming Consistency5/5

    The tool names follow a consistent snake_case pattern with clear verb_noun structure. Both tools start with 'generate_image' and use descriptive suffixes ('with_colors') to indicate variations. This consistency makes the tools easy to identify and understand at a glance.

    Tool Count3/5

    With only 2 tools, the server feels thin for an image generation domain. While the tools cover basic generation with and without color guidance, there are no tools for editing, upscaling, batch processing, or other common image generation operations. The count is borderline minimal for the apparent scope.

    Completeness2/5

    The tool surface is severely incomplete for image generation. There are no tools for modifying generated images (e.g., resize, crop, filter), managing generation parameters beyond colors, handling multiple images, or accessing generation history. The server provides only basic creation functionality without supporting common workflows like iterative refinement or batch processing.

    Maintenance

    ActivityActive
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers