Pyxel MCP Server

Run a Pyxel script and capture a screenshot after N frames. Args: script_path: Absolute path to the .py script to run. frames: Number of frames to render before capturing (default: 60). scale: Screenshot scale multiplier (default: 1). timeout: Maximum seconds to wait for the script (default: 10).

Get Pyxel installation info: package location, examples path, and API stubs path.

Render a Pyxel sound or music to WAV and return waveform analysis. Runs the script to set up sounds (without starting the game loop), then renders the specified sound or music to WAV and analyzes the audio. Returns note sequence with timing, frequency, and volume data. Args: script_path: Absolute path to the .py script to run. sound_index: Sound slot index (default: 0). Default range 0-63, but lists can be extended via append(). Ignored when music_index is set. duration_sec: Duration in seconds. 0 = auto-detect from sound length (10s for music). timeout: Maximum seconds to wait for the script (default: 10). music_index: Music slot index. Default range 0-7, extendable. When set (>=0), renders the full multi-channel music mix instead of a single sound.

Inspect sprite pixel data from a Pyxel image bank. Reads pixel data, checks horizontal/vertical symmetry, and reports color usage. Use this to verify sprite quality and find asymmetries. Args: script_path: Absolute path to the .py script to run. image: Image bank index (default: 0). Default range 0-2, extendable. x: X position in the image bank (default: 0). y: Y position in the image bank (default: 0). w: Width of the region to inspect (default: 8). h: Height of the region to inspect (default: 8). timeout: Maximum seconds to wait for the script (default: 10).

Check animation frame consistency in a sprite sheet. Reads multiple adjacent horizontal frames and compares palette, silhouette size, and pixel differences between frames. Args: script_path: Absolute path to the .py script to run. image: Image bank index (default: 0). x: X position of the first frame (default: 0). y: Y position (default: 0). w: Width of each frame (default: 8). h: Height of each frame (default: 8). frame_count: Number of animation frames to check (default: 2). timeout: Maximum seconds to wait (default: 10).