pyxel-mcp

MCP-сервер для Pyxel, ретро-игрового движка для Python. Позволяет ИИ автономно запускать, проверять и итерировать программы ретро-игр.

Возможности

Запуск и захват

• run_and_capture — запуск скрипта Pyxel и создание скриншота через N кадров

• capture_frames — создание скриншотов в нескольких точках кадров для проверки анимации

• record_gameplay — запись N кадров в формате GIF для проверки анимации/переходов

• play_and_capture — игра в игру путем отправки имитируемого ввода и создание скриншотов

Инспекция и отладка

• validate_script — проверка скрипта Pyxel без его запуска

• inspect_state — чтение атрибутов игровых объектов в определенных кадрах для отладки

• inspect_screen — захват экрана в виде компактной сетки цветовых индексов

• compare_frames — сравнение скриншотов в двух кадрах и отчет о различиях пикселей

Визуальный анализ

• inspect_sprite — инспекция данных пикселей спрайта из банка изображений Pyxel

• inspect_layout — анализ макета экрана, выравнивания текста и визуального баланса

• inspect_palette — анализ использования цветов и контрастности на скриншоте Pyxel

• inspect_bank — визуализация всего банка изображений Pyxel как одного скриншота

• inspect_tilemap — инспекция содержимого тайловой карты, использования тайлов и макета

• inspect_animation — проверка согласованности спрайт-листа по кадрам анимации

Аудио

• render_audio — рендеринг звука или музыки Pyxel в формат WAV и возврат анализа формы волны

Ресурсы (справочник Pyxel)

Помимо инструментов, сервер предоставляет справочные материалы Pyxel в качестве ресурсов MCP:

• pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — официальная документация Pyxel

• pyxel://examples/<name> — официальные примеры Pyxel (например, 02_jump_game)

• pyxel://palette/default — 16-цветная палитра с подсказками по использованию

В Claude Code ссылайтесь на них через @pyxel:examples/02_jump_game и т.д.

Утилиты

• pyxel_info — получение информации об установке Pyxel: расположение пакета, путь к примерам и путь к заглушкам API

Related MCP server: aseprite-mcp

Начало работы

Просто попросите своего ИИ-агента (например, Claude Code) создать игру на Pyxel. Агент автоматически обнаружит и настроит pyxel-mcp из реестра MCP.

Ручная установка

1. Установите пакет:

pip install pyxel-mcp

2. Зарегистрируйте pyxel-mcp как MCP-сервер в вашем ИИ-агенте. Для Claude Code добавьте в файл .mcp.json вашего проекта:

{
  "mcpServers": {
    "pyxel": {
      "type": "stdio",
      "command": "pyxel-mcp"
    }
  }
}

Реестр MCP

mcp-name: io.github.kitao/pyxel-mcp

Лицензия

MIT