Draw Things

Enables local image generation and transformations via Draw Things using MCP on macOS with Apple Silicon.

typescript

0

GitHub Stars

typescript

Language

3 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "james-see-mcp-drawthings": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-drawthings"
      ],
      "env": {
        "DRAWTHINGS_HOST": "localhost",
        "DRAWTHINGS_PORT": "7860",
        "DRAWTHINGS_OUTPUT_DIR": "~/Pictures/drawthings-mcp"
      }
    }
  }
}

You run an MCP server that lets a locally installed Draw Things app generate images on your Mac using Stable Diffusion and other models. It exposes a simple set of endpoints you can reach from MCP clients, enabling you to create images from text prompts, transform existing images, and inspect current settings without leaving your local machine.

How to use

To use this MCP server with your preferred MCP client (for example Claude Desktop or Cursor), enable the Draw Things API server on your Mac and point the client’s MCP configuration at the local service that runs your client commands.

Primary capabilities include generating images from a text prompt, transforming an existing image with a prompt, and querying the current Draw Things configuration and loaded model. All processing happens locally on your Mac.

How to install

Prerequisites you need before starting: macOS with Apple Silicon (M1/M2/M3/M4), Draw Things app installed, and Node.js 18 or later.

Step 1. Enable Draw Things API Server

Open Draw Things
Open Settings and enable API Server / HTTP Server
Leave or verify the server runs on port 7860 by default
Confirm the server is reachable locally

Run this command to verify connectivity

curl http://localhost:7860

Configure MCP clients

You configure MCP clients to talk to Draw Things via a local stdio setup using npx to run the MCP package. Add the following MCP server configuration to each client you use.

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

Restart your MCP client

After adding the new MCP server configuration, restart Claude Desktop or Cursor to load the new server settings.

Configuration and environment

Environment variables you may reference to customize how the Draw Things API is accessed locally:

DRAWTHINGS_HOST defaults to localhost

DRAWTHINGS_PORT defaults to 7860

DRAWTHINGS_OUTPUT_DIR defaults to ~/Pictures/drawthings-mcp

Troubleshooting

Cannot connect to Draw Things API: ensure Draw Things is running, the API Server is enabled, and the local port is correct. Test connectivity with curl http://localhost:7860.

Images not generating: confirm a model is loaded in Draw Things and there are no error messages in Draw Things. Try generating an image directly in Draw Things first to verify the setup.

Permission errors saving images: ensure the output directory is writable or set DRAWTHINGS_OUTPUT_DIR to a writable path.

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 with optional parameters like width, height, steps, cfg_scale, seed, and output path.

transform_image

Transform an existing image using a text prompt (img2img) with options for denoising, steps, seed, and output path.