kitao avatar

Pyxel MCP

kitao/pyxel-mcp

This connects Claude to Pyxel, the retro game engine for Python, letting the AI write games and verify they actually work through visual feedback. You get tools to run scripts and capture screenshots at specific frames, record gameplay as GIFs, simulate player input, and inspect sprites, tilemaps, and color palettes pixel by pixel. It also exposes Pyxel's API docs and example games as MCP resources so Claude can reference them directly. Reach for this when you want an AI coding assistant that can iterate on game code by seeing what it renders, not just hoping the syntax is right.

GitHub stars
32
tools
8
transport
STDIO
last updated
Nov 12, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

validateSyntax errors and recognizable Pyxel code patterns, without executing.

Syntax errors and recognizable Pyxel code patterns, without executing.

No parameter schema in public metadata yet.

runHeadless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.

Headless frames, scheduled input, logs, and state, screen_image, screen_grid, or video snapshots.

No parameter schema in public metadata yet.

pyxel_infoInstalled versions, paths, bundled examples, and resource URIs.

Installed versions, paths, bundled examples, and resource URIs.

No parameter schema in public metadata yet.

read_palettePalette colors and image-bank indices in use.

Palette colors and image-bank indices in use.

No parameter schema in public metadata yet.

read_imageImage-bank pixels and an optional PNG render.

Image-bank pixels and an optional PNG render.

No parameter schema in public metadata yet.

read_tilemapTile coordinates, source bank, usage counts, bounds, and an optional render.

Tile coordinates, source bank, usage counts, bounds, and an optional render.

No parameter schema in public metadata yet.

read_audioA rendered sound or music WAV plus measurable audio data.

A rendered sound or music WAV plus measurable audio data.

No parameter schema in public metadata yet.

diff_framesPixel differences between two PNG files.

Pixel differences between two PNG files.

No parameter schema in public metadata yet.

Sponsors

Readme

pyxel-mcp

Let AI agents play, watch, and measure Pyxel games. pyxel-mcp is an MCP server that runs a Pyxel script headlessly, feeds it scheduled input, stops when a condition holds, and hands back the facts: screenshots, pixel grids, game state, assets, audio, and frame diffs.

PyPI Python Tests License MCP Registry


View the full README on GitHub

Details

Repository
github.com/kitao/pyxel-mcp
Website
github.com/kitao/pyxel-mcp
Category
Design & Creative
Package
pyxel-mcp
Transport
STDIO
Registry
MCP registry, active

Related Design & Creative MCP servers

View all
1apology-is-policy avatarHyadesapology-is-policy/hyadesRender LaTeX math as pure Unicode text art for terminals, code comments, and emails.26stars
2avivgerz-hue avatarunslop — 7-Pillar Design Craft Engineavivgerz-hue/unslopAudit UI design, extract Design DNA, generate tokens, and create transformation blueprints.20stars
3beycom avatarOneTool MCPbeycom/onetool-mcpOne MCP for devs incl Brave,Google,Tavily,Context7,AWS,Excalidraw,DB,GitHub,DevTools,Playwright20stars
4maurerkrisztian avatarPerfboard Designermaurerkrisztian/perfboard-designerDesign perfboard and stripboard layouts, check the wiring and get a link to open them in the editor.20stars
5mobbin avatarMobbinmobbin/mobbin-mcp-serverSearch real-world UI & UX design references for mobile apps, web apps, and websites with Mobbin.17stars
6octoco-ltd avatarSheetsDataoctoco-ltd/sheetsdata-mcpElectronic component datasheets for AI agents: pinouts, specs, package info and design checks.12stars