home / mcp / ketchup draw mcp server

Ketchup Draw MCP Server

An MCP server that integrates Ketchup AI drawing with URUSAI! uploads and automatic prompt optimization.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "komorebi-yaodong-ketchup-draw-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ketchup-draw-mcp-server"
      ],
      "env": {
        "HTTPS_PROXY": "http://127.0.0.1:7890"
      }
    }
  }
}

You can run the Ketchup Draw MCP Server to empower MCP clients like Claude Desktop with advanced drawing capabilities. It combines Ketchup AI for high‑quality generation with URUSAI! for automatic image hosting, giving you optimized prompts, high‑quality images, and permanent image URLs directly in your conversations.

How to use

Once the server is running, you can use it from your MCP client to turn simple prompts into professional, richly described drawings. Start by letting the client optimize your prompt, then generate an image with Ketchup AI, and finally upload the result to URUSAI! so you get a permanent image URL that can be shared in conversations.

How to install

Prerequisites: you need Node.js and npm or npx available on your system.

1) Ensure you have a local proxy if you are in a network where outbound connections to URUSAI! or Ketchup AI are blocked. This is required for successful image uploads in certain environments.

2) Open your terminal and run the following to start the MCP server using npx (no clone needed):

{
  "mcpServers": {
    "ketchup-draw": {
      "command": "npx",
      "args": [
        "-y",
        "ketchup-draw-mcp-server"
      ],
      "env": {
        "HTTPS_PROXY": "http://127.0.0.1:7890"
      }
    }
  }
}

Additional configuration and notes

Proxy configuration is important when URUSAI! and Ketchup AI servers are hosted overseas. In such cases, set the HTTPS_PROXY environment variable to your local proxy port.

Tools exposed by the server

The MCP server exposes two tools you can call from your MCP client.

optimize_prompt

Description: Optimize a simple drawing prompt into a detailed professional prompt using Ketchup AI.

Inputs: prompt (string, required) — the initial description, e.g., "cyberpunk city at night".

generate_image

Description: Generate an image using Ketchup AI and upload it to URUSAI!. Returns the image URL.

Inputs: prompt (string, required) — a detailed drawing prompt (ideally obtained from optimize_prompt); ratio (string, required) — one of the supported aspect ratios listed below.

Supported image ratios

When calling generate_image, use one of these ratio values: 1x1, 16x9, 9x16, 4x3, 3x4, 21x9, 9x21, 3x2, 2x3.

Available tools

optimize_prompt

Convert a short, user-provided prompt into a detailed, professional English drawing prompt using Ketchup AI.

generate_image

Create an image from a detailed prompt using Ketchup AI and upload it to URUSAI!, returning a permanent URL.