Scuffed Painter

Un servidor MCP (Model Context Protocol) que renderiza comandos de dibujo en imágenes rasterizadas usando Pillow. Expone dos herramientas:

• draw_image — renderiza los comandos y devuelve el resultado como una imagen PNG en línea.

• draw_image_to_file — renderiza los comandos y guarda el resultado en un archivo.

Se admiten cinco formas, cada una de ellas un objeto JSON discriminado por su campo "shape":

Los comandos se ejecutan en el orden de la lista sobre un lienzo blanco de tamaño fijo; los comandos posteriores pintan sobre los anteriores. Los colores son nombres de color CSS o códigos hexadecimales.

Instalación

pip install .

Esto proporciona el script de consola scuffed-painter, que inicia el servidor MCP a través de stdio (el valor predeterminado). python -m scuffed_painter es una alternativa equivalente. El mismo comando también puede servir el servidor a través de HTTP (transporte MCP Streamable HTTP):

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 y --port solo se aplican al transporte HTTP; los valores predeterminados son 127.0.0.1 y 8000. Puedes habilitar CORS con --enable-cors si es necesario.

Related MCP server: openai-imagegen-mcp

Configuración del host MCP

stdio

Añade el servidor a la configuración de servidores stdio de tu host MCP:

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

Nota: en un host con un PATH restringido o cuando se ejecute dentro de un virtualenv, usa la ruta absoluta al script scuffed-painter instalado en su lugar (por ejemplo, la que indica which scuffed-painter).

Streamable HTTP

Inicia el servidor tú mismo y luego apunta tu host MCP al endpoint (la ruta es /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"
    }
  }
}

(Ajusta los nombres de las claves para que coincidan con el formato de configuración de tu host MCP).

Nota: cuando se usa draw_image_to_file, output_path se refiere a la máquina en la que se ejecuta el servidor. A través de stdio, esa máquina es el mismo host que el cliente MCP; cuando se accede al servidor a través de HTTP, es el host del servidor en su lugar.

Ejemplo de llamada a la herramienta

{
  "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}
  ]
}

Desarrollo

Estructura del repositorio:

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)

Preparación y ejecución de las pruebas:

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