convez.ai
MCP ServerProdutividadeIntermediário
kitao

Pyxel MCP

kitao/pyxel-mcp

Desenvolvimento de jogos retrô assistido por IA com Pyxel

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que capacita IA a desenvolver jogos retrô autônomos com Pyxel. Oferece ferramentas para executar, capturar frames, validar scripts, inspecionar sprites, tilemaps, paletas e até renderizar áudio, permitindo iteração visual completa de games retro.

Instalação

$npx convez-ai kitao/pyxel-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
32
Forks
3
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
v1.3.2
Issues abertas
5
Contribuidores
1

Casos de uso

  • Criar e iterar jogos retrô com validação visual automatizada
  • Debugar comportamento de sprites, animações e física de game
  • Analisar layouts, paletas de cores e consistência visual em tempo real

Veredito

MCP especializado e bem-construído para game dev retrô. Cobre o ciclo completo (validação, execução, captura, inspeção), integrando perfeitamente com Claude Code. Nicho legítimo com implementação técnica sólida.

README

A tradução para o português deste README ainda está na fila.

pyxel-mcp

MCP server for Pyxel, a retro game engine for Python. Enables AI to autonomously run, verify, and iterate on retro game programs.

Features

Run & Capture

  • run_and_capture — Run a Pyxel script and capture a screenshot after N frames
  • capture_frames — Capture screenshots at multiple frame points for animation verification
  • record_gameplay — Record N frames as a GIF for animation/transition verification
  • play_and_capture — Play a game by sending simulated input and capture screenshots

Inspect & Debug

  • validate_script — Validate a Pyxel script without running it
  • inspect_state — Read game object attributes at specific frames for debugging
  • inspect_screen — Capture screen as a compact color index grid
  • compare_frames — Compare screenshots at two frames and report pixel differences

Visual Analysis

  • inspect_sprite — Inspect sprite pixel data from a Pyxel image bank
  • inspect_layout — Analyze screen layout, text alignment, and visual balance
  • inspect_palette — Analyze color usage and contrast in a Pyxel screenshot
  • inspect_bank — Visualize an entire Pyxel image bank as a single screenshot
  • inspect_tilemap — Inspect tilemap content, tile usage, and layout
  • inspect_animation — Check sprite sheet consistency across animation frames

Audio

  • render_audio — Render a Pyxel sound or music to WAV and return waveform analysis

Resources (Pyxel reference)

In addition to tools, the server exposes Pyxel reference content as MCP Resources:

  • pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — official Pyxel docs
  • pyxel://examples/<name> — official Pyxel examples (e.g. 02_jump_game)
  • pyxel://palette/default — 16-color palette with use hints

In Claude Code, reference them with @pyxel:examples/02_jump_game etc.

Utility

  • pyxel_info — Get Pyxel installation info: package location, examples path, and API stubs path

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.

Manual Installation

  1. Install the package:
pip install pyxel-mcp
  1. Register pyxel-mcp as an MCP server in your AI agent. For Claude Code, add to your project's .mcp.json:
{
  "mcpServers": {
    "pyxel": {
      "type": "stdio",
      "command": "pyxel-mcp"
    }
  }
}

MCP Registry

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

License

MIT

Ver o original no GitHub

Bom para

Relacionados