pyxel-mcp

Servidor MCP para Pyxel, un motor de juegos retro para Python. Permite a la IA ejecutar, verificar e iterar de forma autónoma sobre programas de juegos retro.

Características

Ejecutar y capturar

• run_and_capture — Ejecuta un script de Pyxel y captura una captura de pantalla después de N fotogramas

• capture_frames — Captura capturas de pantalla en múltiples puntos de fotogramas para la verificación de animaciones

• record_gameplay — Graba N fotogramas como un GIF para la verificación de animaciones/transiciones

• play_and_capture — Juega a un juego enviando entradas simuladas y captura capturas de pantalla

Inspeccionar y depurar

• validate_script — Valida un script de Pyxel sin ejecutarlo

• inspect_state — Lee los atributos de los objetos del juego en fotogramas específicos para la depuración

• inspect_screen — Captura la pantalla como una cuadrícula compacta de índices de color

• compare_frames — Compara capturas de pantalla en dos fotogramas e informa de las diferencias de píxeles

Análisis visual

• inspect_sprite — Inspecciona los datos de píxeles de un sprite desde un banco de imágenes de Pyxel

• inspect_layout — Analiza el diseño de la pantalla, la alineación del texto y el equilibrio visual

• inspect_palette — Analiza el uso del color y el contraste en una captura de pantalla de Pyxel

• inspect_bank — Visualiza todo un banco de imágenes de Pyxel como una sola captura de pantalla

• inspect_tilemap — Inspecciona el contenido del mapa de mosaicos, el uso de mosaicos y el diseño

• inspect_animation — Comprueba la consistencia de la hoja de sprites a través de los fotogramas de animación

Audio

• render_audio — Renderiza un sonido o música de Pyxel a WAV y devuelve el análisis de la forma de onda

Recursos (referencia de Pyxel)

Además de las herramientas, el servidor expone el contenido de referencia de Pyxel como recursos MCP:

• pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — documentación oficial de Pyxel

• pyxel://examples/<name> — ejemplos oficiales de Pyxel (p. ej., 02_jump_game)

• pyxel://palette/default — paleta de 16 colores con sugerencias de uso

En Claude Code, haz referencia a ellos con @pyxel:examples/02_jump_game etc.

Utilidad

• pyxel_info — Obtiene información de la instalación de Pyxel: ubicación del paquete, ruta de los ejemplos y ruta de los stubs de la API

Related MCP server: aseprite-mcp

Introducción

Simplemente pídele a tu agente de IA (p. ej., Claude Code) que cree un juego de Pyxel. El agente descubrirá y configurará automáticamente pyxel-mcp desde el Registro MCP.

Instalación manual

1. Instala el paquete:

pip install pyxel-mcp

2. Registra pyxel-mcp como un servidor MCP en tu agente de IA. Para Claude Code, añádelo al archivo .mcp.json de tu proyecto:

{
  "mcpServers": {
    "pyxel": {
      "type": "stdio",
      "command": "pyxel-mcp"
    }
  }
}

Registro MCP

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

Licencia

MIT