Scuffed Painter

An MCP (Model Context Protocol) server that renders drawing commands into raster images using Pillow. It exposes two tools:

• draw_image — render the commands and return the result as an inline PNG image.

• draw_image_to_file — render the commands and save the result to a file.

Five shapes are supported, each a JSON object discriminated by its "shape" field:

Commands run in list order on a fixed-size white canvas; later commands overpaint earlier ones. Colors are CSS color names or hex codes.

Installation

pip install .

This provides the scuffed-painter console script, which launches the MCP server over stdio (the default). python -m scuffed_painter is an equivalent alternative. The same command can also serve the server over HTTP (MCP Streamable HTTP transport):

scuffed-painter                              # stdio transport (default)
scuffed-painter --transport http             # HTTP on 127.0.0.1:8000
scuffed-painter --transport http --host H --port P

--host and --port only apply to the HTTP transport; the defaults are 127.0.0.1 and 8000. You may enable CORS with --enable-cors if necessary.

Related MCP server: openai-imagegen-mcp

MCP host configuration

stdio

Add the server to your MCP host's stdio server configuration:

{
  "mcpServers": {
    "scuffed-painter": {
      "command": "scuffed-painter"
    }
  }
}

Note: on a host with a restricted PATH or when running inside a virtualenv, use the absolute path to the installed scuffed-painter script instead (e.g. the one reported by which scuffed-painter).

Streamable HTTP

Start the server yourself, then point your MCP host at the endpoint (the path is /mcp):

scuffed-painter --transport http --host 127.0.0.1 --port 8000

{
  "mcpServers": {
    "scuffed-painter": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

(Adjust the key names to match your MCP host's configuration format.)

Note: when draw_image_to_file is used, output_path refers to the machine the server runs on. Over stdio that is the same host as the MCP client; when the server is reached over HTTP, it is the server's host instead.

Example tool call

{
  "width": 200,
  "height": 200,
  "commands": [
    {"shape": "circle", "center": [100, 80], "radius": 50, "fill": "gold", "outline": "orange", "width": 3},
    {"shape": "triangle", "points": [[50, 170], [150, 170], [100, 70]], "fill": "darkgreen"},
    {"shape": "line", "start": [20, 185], "end": [180, 185], "color": "black", "width": 2}
  ]
}

Development

Repository layout:

scuffed_painter/          the package
  server.py             server, tools, command models, rendering
  __init__.py           re-exports mcp, defines __version__
  __main__.py           python -m scuffed_painter support
  py.typed              typing marker
tests/                  pytest suite (in-process fastmcp.Client)

Setup and running the tests:

pip install -e ".[dev]"
python -m pytest