Happy slice of mcp pizzaMCP.pizza

pyxel-mcp

MCP.Pizza Chef: kitao

This server connects your AI assistant with Pyxel, a tool for making retro-style games. It lets your assistant check your game code for errors, run the game without showing a window to capture images and state, and extract game assets like images, sounds, and palettes. You can use it in MCP-friendly apps like Claude Code by adding it with a simple command. No coding is needed, just a small setup step.

Coding
Images/Design
Other

Use This MCP server To

Check Pyxel game scripts for syntax errors Run my Pyxel game headlessly to capture frames Take screenshots of game frames automatically Extract palette and image data from my game Compare differences between game frames Listen to and analyze game audio output Get detailed info about my Pyxel installation

README

pyxel-mcp

An MCP server for observing programs built with Pyxel. It runs trusted local scripts headlessly and returns structured state, pixels, assets, audio, and frame differences.

PyPI Python Tests License MCP Registry

The server deliberately reports facts rather than a universal quality score. The agent using it chooses the checks that matter for the game.

Install

With Claude Code:

claude mcp add pyxel -- uvx pyxel-mcp

For another MCP client, run uvx pyxel-mcp install or add:

   {
     "mcpServers": {
       "pyxel": {
         "command": "uvx",
         "args": ["pyxel-mcp"]
       }
     }
   }

Restart the client after changing its configuration. The server writes this diagnostic to stderr:

[pyxel-mcp] starting - 8 tools

Python 3.11+ is required, and Pyxel >= 2.9.6 is installed as a dependency. Script tools execute local Python in subprocesses to isolate Pyxel state, but they do not sandbox untrusted code. See SECURITY.md.

Tools

Every script argument is a file path, not Python source.

pyxel-mcp FAQ

Can I use this to check my Pyxel game code for errors?
Yes — it validates Pyxel scripts for syntax and common code patterns to help you catch mistakes early.
Can I capture screenshots and game state during gameplay?
Yes — it can run your Pyxel game headlessly and take snapshots of the screen and game state at specified moments.
Does this work inside apps like Claude or Cursor?
It works with any MCP-compatible client that supports adding servers via uvx, including Claude Code.
Do I need to write code to set it up?
Setup requires copying a small config snippet into your MCP client and running a command, no programming needed.
Do I need an API key or account?
No — this runs locally and does not require any online account or key.
What Python version do I need?
Python 3.11 or higher is required, and Pyxel 2.9.6 or newer is installed automatically.