https://github.com/kitao/pyxel-mcp

An MCP server for Pyxel, a retro game engine for Python
https://github.com/kitao/pyxel-mcp

ai claude game-engine mcp model-context-protocol pixel-art pyxel retro-game

Last synced: 3 months ago
JSON representation

An MCP server for Pyxel, a retro game engine for Python

• Host: GitHub
• URL: https://github.com/kitao/pyxel-mcp
• Owner: kitao
• License: mit
• Created: 2026-03-01T01:50:25.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-03-02T16:00:35.000Z (3 months ago)
• Last Synced: 2026-03-05T06:54:44.162Z (3 months ago)
• Topics: ai, claude, game-engine, mcp, model-context-protocol, pixel-art, pyxel, retro-game
• Language: Python
• Homepage: https://github.com/kitao/pyxel
• Size: 49.8 KB
• Stars: 5
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-mcp-security - pyxel-mcp - githubcom-kitao-pyxel-mcp) | (カテゴリ / 🛠️ <a name="developer-tools"></a>開発ツール)
• awesome-mcp-servers - Pyxel MCP - MCP server for Pyxel retro game engine, allowing AI to run games, capture screenshots, inspect sprites, and analyze audio. ([Read more](/details/pyxel-mcp.md)) `Open Source` `Python` `Retro Gaming` (Game Server MCP Implementations)

README

          
# pyxel-mcp

MCP server for [Pyxel](https://github.com/kitao/pyxel), a retro game engine for Python. Enables AI to autonomously run, verify, and iterate on retro game programs.

## Features

- **`run_and_capture`** — Run a Pyxel script and capture a screenshot for visual verification

- **`capture_frames`** — Capture screenshots at multiple frame points for animation verification

- **`inspect_sprite`** — Read sprite pixel data from image banks, report symmetry and colors

- **`inspect_layout`** — Analyze screen layout, text positioning, and visual balance

- **`render_audio`** — Render a Pyxel sound to WAV and analyze notes, rhythm, and key

- **`pyxel_info`** — Get Pyxel installation paths (API stubs, examples)

## Getting Started

Just ask your AI agent (e.g. Claude Code) to create a Pyxel game. The agent will automatically discover and set up pyxel-mcp from the [MCP Registry](https://registry.modelcontextprotocol.io/).

## Manual Installation

1. Install the package:

```bash

pip install pyxel-mcp

```

2. Register `pyxel-mcp` as an MCP server in your AI agent. For Claude Code, add to your project's `.mcp.json`:

```json

{

  "mcpServers": {

    "pyxel": {

      "type": "stdio",

      "command": "pyxel-mcp"

    }

  }

}

```

## MCP Registry

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

## License

MIT