Draw Things MCP Cursor

🚀 Draw Things MCP

Integrate the Draw Things API into Cursor using the Model Context Protocol (MCP).

🚀 Quick Start

This tool enables the integration of the Draw Things API into Cursor via the Model Context Protocol (MCP).

✨ Features

• Integrate Draw Things API into Cursor.
• Generate images through CLI or within Cursor.
• Customize image generation parameters.

📦 Installation

Prerequisites

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

Installation Steps

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

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

💻 Usage Examples

Cursor Integration

To set up this tool in Cursor, refer to 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

Basic Usage

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

Advanced Usage

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

Parameters

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

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 - Prompt text for image generation
  negative_prompt?: string;  // Optional - 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 the file name: <sanitized_prompt>_<timestamp>.png

📚 Documentation

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 that the Draw Things API is running at http://127.0.0.1:7888.
• If using Cursor, check the log files in the ~/.cursor directory.
• Ensure that the Node.js version is >= 14.0.0.

📄 License

MIT