pyxel-mcp

MCP-Server für Pyxel, eine Retro-Game-Engine für Python. Ermöglicht es KI, Retro-Spielprogramme autonom auszuführen, zu verifizieren und zu iterieren.

Funktionen

Ausführen & Erfassen

• run_and_capture — Führt ein Pyxel-Skript aus und erstellt nach N Frames einen Screenshot

• capture_frames — Erstellt Screenshots an mehreren Frame-Punkten zur Animationsüberprüfung

• record_gameplay — Zeichnet N Frames als GIF zur Überprüfung von Animationen/Übergängen auf

• play_and_capture — Spielt ein Spiel durch Senden simulierter Eingaben und erstellt Screenshots

Inspizieren & Debuggen

• validate_script — Validiert ein Pyxel-Skript, ohne es auszuführen

• inspect_state — Liest Spielobjekt-Attribute an bestimmten Frames zum Debuggen aus

• inspect_screen — Erfasst den Bildschirm als kompaktes Farbindex-Raster

• compare_frames — Vergleicht Screenshots an zwei Frames und meldet Pixelunterschiede

Visuelle Analyse

• inspect_sprite — Inspiziert Sprite-Pixeldaten aus einer Pyxel-Image-Bank

• inspect_layout — Analysiert Bildschirmlayout, Textausrichtung und visuelle Balance

• inspect_palette — Analysiert Farbnutzung und Kontrast in einem Pyxel-Screenshot

• inspect_bank — Visualisiert eine gesamte Pyxel-Image-Bank als einzelnen Screenshot

• inspect_tilemap — Inspiziert Tilemap-Inhalt, Tile-Nutzung und Layout

• inspect_animation — Überprüft die Konsistenz des Sprite-Sheets über Animationsframes hinweg

Audio

• render_audio — Rendert einen Pyxel-Sound oder Musik zu WAV und gibt eine Wellenformanalyse zurück

Ressourcen (Pyxel-Referenz)

Zusätzlich zu den Werkzeugen stellt der Server Pyxel-Referenzinhalte als MCP-Ressourcen bereit:

• pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — offizielle Pyxel-Dokumentation

• pyxel://examples/<name> — offizielle Pyxel-Beispiele (z. B. 02_jump_game)

• pyxel://palette/default — 16-Farben-Palette mit Verwendungshinweisen

In Claude Code referenzieren Sie diese mit @pyxel:examples/02_jump_game usw.

Dienstprogramm

• pyxel_info — Ruft Pyxel-Installationsinformationen ab: Paketpfad, Beispielpfad und API-Stub-Pfad

Related MCP server: aseprite-mcp

Erste Schritte

Bitten Sie einfach Ihren KI-Agenten (z. B. Claude Code), ein Pyxel-Spiel zu erstellen. Der Agent wird pyxel-mcp automatisch aus dem MCP Registry entdecken und einrichten.

Manuelle Installation

1. Installieren Sie das Paket:

pip install pyxel-mcp

2. Registrieren Sie pyxel-mcp als MCP-Server in Ihrem KI-Agenten. Fügen Sie für Claude Code Folgendes zu Ihrer .mcp.json im Projekt hinzu:

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

MCP Registry

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

Lizenz

MIT