papilio MCP server

Papilio Arcade MCP服务器

MCP（模型上下文协议）服务器和调试固件，允许GitHub Copilot等AI助手直接控制Papilio Arcade FPGA板。

组件

此库包含：

1. MCP服务器 （Python）-在主机PC上运行，将MCP工具调用转换为串行命令
2. 凤尾鱼。h （Arduino）-仅标题库，用于将MCP调试添加到任何草图中
3. 固件示例 -即用型调试固件草图

快速入门-将MCP调试添加到任何草图中

添加MCP调试功能的最简单方法是使用头库：

// Add BEFORE setup() - comment out to disable
#define PAPILIO_MCP_ENABLED
#include 

void setup() {
  Serial.begin(115200);
  // ... your setup code ...
  
  PapilioMCP.begin();  // Initialize MCP (does nothing if disabled)
}

void loop() {
  PapilioMCP.update();  // Process MCP commands (does nothing if disabled)
  
  // ... your loop code ...
}

当 PAPILIO_MCP_ENABLED 未定义， PapilioMCP.begin() 和 PapilioMCP.update() 编译为空存根-开销为零。

快速入门-使用调试固件

1.上传调试固件

# From project root
pio run -e mcp_debug_firmware -t upload

或者使用Makefile：

make mcp_debug_firmware-upload

2.配置VS代码MCP

这 .vscode/mcp.json 应该已经配置好了。如果没有，请添加：

{
  "servers": {
    "papilio": {
      "type": "stdio",
      "command": "python",
      "args": ["libs/papilio_mcp_server/server/papilio_mcp_server.py", "--port", "COM4"]
    }
  }
}

3.安装Python依赖项

pip install pyserial opencv-python

平台IO构建环境

在你的 platformio.ini，您可以通过构建标志将MCP调试添加到任何环境中：

; Normal build - MCP disabled
[env:my_project]
extends = env:papilio_arcade

; Debug build - MCP enabled
[env:my_project_debug]
extends = env:papilio_arcade
build_flags = ${env:papilio_arcade.build_flags}
              -DPAPILIO_MCP_ENABLED

特性

• RGB LED控制：设置和读取RGB LED颜色
• Wishbone巴士通道：读/写任何Wishbone巴士地址
• FPGA状态：获取调试转储和状态信息
• 串行端口管理：列出端口并连接到板
• 电脑屏幕截图工具：捕获HDMI输出的网络摄像头图像
• 视频模式控制：在测试模式、文本模式和帧缓冲区之间切换
• 文本模式：将文本写入80x26文本显示
• JTAG桥：为FPGA编程启用USB JTAG直通

串行命令（通过PapilioMCP.h）

可用的MCP工具

RGB LED控制

Wishbone巴士通道

董事会管理

电脑屏幕截图工具

视频模式控制

视频模式：

• 0：颜色条
• 1：网格图案
• 2：灰度梯度
• 3：文本模式（80x26）
• 4：帧缓冲区（160x120 RGB332）

文本模式

Wishbone地址图

使用示例

配置MCP服务器后，您可以询问Copilot：

• “将RGB LED设置为红色”
• “将LED变为蓝色”
• “读取当前LED颜色”
• “将0xFF写入地址0x8100”
• “切换到文本模式”
• “在位置10,5处写下‘Hello World’”
• “截图”
• “运行原始命令H”

文件结构

papilio_mcp_server/
├── library.json           # PlatformIO library manifest
├── README.md              # This file
├── src/
│   └── PapilioMCP.h       # Header-only library for sketches
├── server/
│   └── papilio_mcp_server.py  # Main MCP server
└── examples/
    ├── mcp_debug_simple/      # Minimal debug firmware
    └── mcp_debug_firmware_full/  # Full-featured debug firmware