Amazon Nova Canvas MCP Server

Amazon Nova Canvas MCP Server is a deprecated AWS Labs MCP server for generating images with Amazon Nova Canvas through Amazon Bedrock. The reviewed package artifact is PyPI awslabs.nova-canvas-mcp-server version 1.0.15; the package metadata points to the broader awslabs/mcp repository, but the formerly advertised package subfolders src/nova-canvas-mcp-server and src/nova-mcp-server were not present at the reviewed GitHub commit, so the PyPI source distribution was used as authoritative source evidence.

Installation

The upstream README documents the default MCP client launch with uvx over stdio and awslabs.nova-canvas-mcp-server@latest. This registry entry pins the default launch to the reviewed package version to avoid drift:

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

The package requires Python >=3.10. README prerequisites are uv, Python installed with uv python install 3.10, and AWS credentials with access to Amazon Bedrock and Amazon Nova Canvas.

The README also documents alternate installation/launch paths: Windows uv tool run --from awslabs.nova-canvas-mcp-server@latest awslabs.nova-canvas-mcp-server.exe, local Docker build/run, and a Smithery installer command. Those alternate-launch and installer flags are not package arguments for the default uvx package target.

Configuration

AWS_REGION defaults to us-east-1 and is used when creating the boto3 Bedrock Runtime client. AWS_PROFILE selects an AWS profile; when it is absent or empty, boto3's default credential chain is used. Docker examples also document temporary credential variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_SESSION_TOKEN. FASTMCP_LOG_LEVEL defaults to WARNING; README examples use ERROR.

Capabilities

The server exposes two tools: generate_image and generate_image_with_colors. Both call Amazon Nova Canvas model amazon.nova-canvas-v1:0 through Bedrock Runtime, save returned images as PNG files, and return file:// paths. Text generation supports prompts, negative prompts, optional filename, width and height, quality, cfg scale, seed, image count, and workspace directory. Color-guided generation adds a list of up to 10 hex color values. Generated images are saved in an output directory under the supplied workspace_dir, or in a local output directory if no workspace is supplied.

Limitations

The server is deprecated and no longer receives updates. The migration guide recommends bedrock-image-mcp-server, which keeps equivalent Nova Canvas tools and adds Stable Diffusion, upscaling, and image editing tools. SSE support was removed in version 1.0.0, so the registry target is stdio only. Image prompts are limited to 1024 characters. Width and height must be 320-4096, divisible by 16. number_of_images is limited to 1-5; cfg_scale is 1.1-10.0; seed is 0-858,993,459. AWS account access to Amazon Bedrock and Nova Canvas is required. The package writes generated PNG files to output/ under workspace_dir or the current directory.