pyxel-mcp

用于 Pyxel（一个 Python 复古游戏引擎）的 MCP 服务器。使 AI 能够自主运行、验证和迭代复古游戏程序。

功能

运行与捕获

• run_and_capture — 运行 Pyxel 脚本并在 N 帧后捕获截图

• capture_frames — 在多个帧点捕获截图以进行动画验证

• record_gameplay — 将 N 帧记录为 GIF 以进行动画/过渡验证

• play_and_capture — 通过发送模拟输入来玩游戏并捕获截图

检查与调试

• validate_script — 在不运行的情况下验证 Pyxel 脚本

• inspect_state — 在特定帧读取游戏对象属性以进行调试

• inspect_screen — 将屏幕捕获为紧凑的颜色索引网格

• compare_frames — 比较两帧的截图并报告像素差异

视觉分析

• inspect_sprite — 检查来自 Pyxel 图像库的精灵像素数据

• inspect_layout — 分析屏幕布局、文本对齐和视觉平衡

• inspect_palette — 分析 Pyxel 截图中的颜色使用和对比度

• inspect_bank — 将整个 Pyxel 图像库可视化为单张截图

• inspect_tilemap — 检查瓦片地图内容、瓦片使用情况和布局

• inspect_animation — 检查跨动画帧的精灵表一致性

音频

• render_audio — 将 Pyxel 音效或音乐渲染为 WAV 并返回波形分析

资源 (Pyxel 参考)

除了工具外，该服务器还将 Pyxel 参考内容作为 MCP 资源公开：

• pyxel://api-reference, pyxel://user-guide, pyxel://mml-commands, pyxel://pyxres-format — 官方 Pyxel 文档

• pyxel://examples/<name> — 官方 Pyxel 示例（例如 02_jump_game）

• pyxel://palette/default — 带有使用提示的 16 色调色板

在 Claude Code 中，使用 @pyxel:examples/02_jump_game 等方式引用它们。

实用工具

• pyxel_info — 获取 Pyxel 安装信息：包位置、示例路径和 API 存根路径

Related MCP server: aseprite-mcp

入门指南

只需让您的 AI 代理（例如 Claude Code）创建一个 Pyxel 游戏。代理将自动从 MCP 注册表发现并设置 pyxel-mcp。

手动安装

1. 安装包：

pip install pyxel-mcp

2. 在您的 AI 代理中将 pyxel-mcp 注册为 MCP 服务器。对于 Claude Code，请添加到项目的 .mcp.json 中：

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

MCP 注册表

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

许可证

MIT