Pyxel MCP

紫杉醇mcp

MCP服务器 紫杉醇，Python的复古游戏引擎。使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/ --Pyxel官方示例（例如。 02_jump_game)
• pyxel://palette/default --16色调色板，带使用提示

在克劳德准则中，用 @pyxel:examples/02_jump_game 等等

效用

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

入门指南

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

手动安装

1. 安装软件包：

pip install pyxel-mcp

1. 注册 pyxel-mcp 作为AI代理中的MCP服务器。对于Claude Code，添加到您的项目 .mcp.json:

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

MCP注册表

mcp名称：io.github.kitao/pyxel-mcp

许可证

麻省理工学院