Scuffed Painter

Ein MCP-Server (Model Context Protocol), der Zeichenbefehle mithilfe von Pillow in Rasterbilder rendert. Er stellt zwei Werkzeuge bereit:

• draw_image — rendert die Befehle und gibt das Ergebnis als Inline-PNG-Bild zurück.

• draw_image_to_file — rendert die Befehle und speichert das Ergebnis in einer Datei.

Es werden fünf Formen unterstützt, jede davon ein JSON-Objekt, das anhand seines "shape"-Felds unterschieden wird:

Die Befehle werden in der Reihenfolge der Liste auf einer weißen Leinwand fester Größe ausgeführt; spätere Befehle übermalen frühere. Farben sind CSS-Farbnamen oder Hex-Codes.

Installation

pip install .

Dadurch wird das Konsolenskript scuffed-painter bereitgestellt, das den MCP-Server über stdio startet (der Standard). python -m scuffed_painter ist eine gleichwertige Alternative. Derselbe Befehl kann den Server auch über HTTP bereitstellen (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 und --port gelten nur für den HTTP-Transport; die Standardwerte sind 127.0.0.1 und 8000. Bei Bedarf können Sie CORS mit --enable-cors aktivieren.

Related MCP server: openai-imagegen-mcp

MCP-Host-Konfiguration

stdio

Fügen Sie den Server zur stdio-Serverkonfiguration Ihres MCP-Hosts hinzu:

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

Hinweis: Auf einem Host mit eingeschränktem PATH oder beim Ausführen innerhalb eines virtualenv verwenden Sie stattdessen den absoluten Pfad zum installierten scuffed-painter-Skript (z. B. den von which scuffed-painter gemeldeten).

Streamable HTTP

Starten Sie den Server selbst und weisen Sie dann Ihren MCP-Host auf den Endpunkt hin (der Pfad ist /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"
    }
  }
}

(Passen Sie die Schlüsselnamen an das Konfigurationsformat Ihres MCP-Hosts an.)

Hinweis: Wenn draw_image_to_file verwendet wird, bezieht sich output_path auf den Rechner, auf dem der Server läuft. Über stdio ist das derselbe Host wie der MCP-Client; wenn der Server über HTTP erreicht wird, ist es stattdessen der Host des Servers.

Beispiel für einen Werkzeugaufruf

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

Entwicklung

Repository-Struktur:

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)

Einrichtung und Ausführen der Tests:

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