Draw Things MCP

Draw Things API integration for Cursor using Model Context Protocol (MCP).

Prerequisites

• Node.js >= 14.0.0
• Draw Things API running on http://127.0.0.1:7888

Installation

# Install globally
npm install -g draw-things-mcp-cursor

# Or run directly
npx draw-things-mcp-cursor

Cursor Integration

To set up this tool in Cursor, see the detailed guide in cursor-setup.md.

Quick setup:

1. Create or edit `~/.cursor/claude_desktop_config.json`:

{
  "mcpServers": {
    "draw-things": {
      "command": "draw-things-mcp-cursor",
      "args": []
    }
  }
}

2. Restart Cursor

3. Use in Cursor: `generateImage({"prompt": "a cute cat"})`

CLI Usage

Generate Image

echo '{"prompt": "your prompt here"}' | npx draw-things-mcp-cursor

Parameters

• `prompt`: The text prompt for image generation (required)
• `negative_prompt`: The negative prompt for image generation
• `width`: Image width (default: 360)
• `height`: Image height (default: 360)
• `steps`: Number of steps for generation (default: 8)
• `model`: Model to use for generation (default: "flux_1_schnell_q5p.ckpt")
• `sampler`: Sampling method (default: "DPM++ 2M AYS")

Example:

echo '{
  "prompt": "a happy smiling dog, professional photography",
  "negative_prompt": "ugly, deformed, blurry",
  "width": 360,
  "height": 360,
  "steps": 4
}' | npx draw-things-mcp-cursor

MCP Tool Integration

When used as an MCP tool in Cursor, the tool will be registered as `generateImage` with the following parameters:

{
  prompt: string;       // Required - The prompt to generate the image from
  negative_prompt?: string;  // Optional - The negative prompt
  width?: number;       // Optional - Image width (default: 360)
  height?: number;      // Optional - Image height (default: 360)
  model?: string;       // Optional - Model name
  steps?: number;       // Optional - Number of steps (default: 8)
}

The generated images will be saved in the `images` directory with a filename format of:

`_.png`

Response Format

Success:

{
  "type": "success",
  "content": [{
    "type": "image",
    "data": "base64 encoded image data",
    "mimeType": "image/png"
  }],
  "metadata": {
    "parameters": { ... }
  }
}

Error:

{
  "type": "error",
  "error": "error message",
  "code": 500
}

Troubleshooting

If you encounter issues:

• Ensure Draw Things API is running at http://127.0.0.1:7888
• Check log files in `~/.cursor/logs` if using with Cursor
• Make sure src/index.js has execution permissions: `chmod +x src/index.js`

License

MIT