mcp/nova-canvas-mcp-server repository overview

⁠AWS Labs Nova Canvas MCP Server

AI image generation using Amazon Nova Canvas.

What is an MCP Server?⁠

⁠MCP Info

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/awslabs/mcp/blob/76ec6993aec4c6281e5250cbeba8db6a5863f2ff/src/nova-canvas-mcp-server/Dockerfile⁠
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/nova-canvas-mcp-server --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub
Licence	Apache License 2.0

⁠Available Tools (2)

⁠Tools Details

⁠Tool: generate_image

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.

    CRITICAL: Assistant must always provide the current IDE workspace directory parameter to save images to the user's current project.

⁠Tool: generate_image_with_colors

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.

⁠Use this MCP Server

{
  "mcpServers": {
    "awslabs-nova-canvas": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "mcp/nova-canvas-mcp-server"
      ]
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠