Drawthings MCP server

mcp-drawthings

An MCP (Model Context Protocol) server for Draw Things - enabling LLMs to generate images locally on Mac using Stable Diffusion and other AI models.

Features

• Text-to-Image Generation - Generate images from text prompts using the currently loaded model in Draw Things
• Image-to-Image Transformation - Transform existing images using text prompts
• Configuration Access - Query the current Draw Things settings and loaded model
• Local Processing - All image generation runs locally on your Mac using Apple Silicon (M1/M2/M3/M4)

Prerequisites

• macOS with Apple Silicon (M1/M2/M3/M4)
• Draw Things app installed
• Node.js 18 or later

Setup

1. Enable Draw Things API Server

1. Open Draw Things
2. Click the gear icon (⚙️) to open Settings
3. Enable API Server / HTTP Server
4. The server runs on port 7860 by default

Verify the server is running:

curl http://localhost:7860

2. Configure Your MCP Client

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json:

{
  "mcpServers": {
    "drawthings": {
      "command": "npx",
      "args": ["-y", "mcp-drawthings"]
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project or global config:

{
  "mcpServers": {
    "drawthings": {
      "command": "npx",
      "args": ["-y", "mcp-drawthings"]
    }
  }
}

3. Restart Your MCP Client

Restart Claude Desktop or Cursor to load the new MCP server.

Available Tools

check_status

Check if the Draw Things API server is running and accessible.

get_config

Get the current Draw Things configuration including the loaded model and settings.

generate_image

Generate an image from a text prompt.

Parameters:

Example:

Generate an image of a futuristic city at sunset with flying cars

transform_image

Transform an existing image using a text prompt (img2img).

Parameters:

Either imagepath or image_base64 must be provided.

Configuration

Environment Variables

Architecture

Shortened. The full README is on GitHub.