Scuffed Painter

Сервер MCP (Model Context Protocol), который рендерит команды рисования в растровые изображения с помощью Pillow. Он предоставляет два инструмента:

• draw_image — рендерит команды и возвращает результат в виде встроенного PNG-изображения.

• draw_image_to_file — рендерит команды и сохраняет результат в файл.

Поддерживаются пять фигур, каждая из которых представляет собой JSON-объект, тип которого определяется полем "shape":

Команды выполняются в порядке списка на белом холсте фиксированного размера; более поздние команды перекрывают более ранние. Цвета задаются названиями цветов CSS или hex-кодами.

Установка

pip install .

Этот пакет предоставляет консольный скрипт scuffed-painter, который запускает MCP-сервер через stdio (по умолчанию). python -m scuffed_painter — эквивалентная альтернатива. Та же команда может также запускать сервер через HTTP (транспорт 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 и --port применяются только к HTTP-транспорту; значения по умолчанию — 127.0.0.1 и 8000. При необходимости можно включить CORS с помощью --enable-cors.

Related MCP server: openai-imagegen-mcp

Конфигурация MCP-хоста

stdio

Добавьте сервер в конфигурацию stdio-серверов вашего MCP-хоста:

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

Примечание: на хосте с ограниченным PATH или при работе внутри virtualenv используйте абсолютный путь к установленному скрипту scuffed-painter (например, тот, который выводит which scuffed-painter).

Streamable HTTP

Запустите сервер самостоятельно, затем укажите вашему MCP-хосту конечную точку (путь — /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"
    }
  }
}

(Скорректируйте имена ключей в соответствии с форматом конфигурации вашего MCP-хоста.)

Примечание: при использовании draw_image_to_file параметр output_path указывает на машину, на которой работает сервер. При работе через stdio это тот же хост, что и MCP-клиент; когда сервер доступен через HTTP, это хост сервера.

Пример вызова инструмента

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

Разработка

Структура репозитория:

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)

Настройка и запуск тестов:

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