crosspad-mcp

crosspad-mcp

与 CrossPad 对话，让 Claude 处理工具链。

crosspad-mcp 是一个 MCP 服务，可教会 Claude Code（或任何 MCP 客户端）如何为 CrossPad 打击垫控制器进行开发。你只需说 “刷入新构建版本并检查它是否启动”；它就会运行 ESP-IDF 构建，请你确认刷写，打开控制台，运行冒烟测试场景并告知结果——硬件相关的陷阱也已内置，因此你不必记住打开串口时哪个端口会让开发板重启。

你可以用它做什么

每张卡片都是一个真实的提示词。下方列出的工具就是实际执行的内容——你无需亲自调用它们。

说这句话……	……就会发生这些事
“构建固件并通过 OTA 刷写。”	crosspad_build platform=idf 会持续输出构建进度，crosspad_flash transport=ota 会请求确认，然后持续输出上传进度。系统会检测新的应用目录，并自动执行 fullclean。
“给我看看模拟器屏幕上显示了什么。”	crosspad_run 会启动 PC 模拟器，crosspad_screenshot 会返回 LCD 图像，让 Claude 能实际查看。接着你可以说 “按下打击垫 5”、“将编码器向左转两次”——由 crosspad_input 执行。
“用打击垫演奏一段鼓点，并录下声音。”	crosspad_stimulus 会按照实际时序敲击打击垫，crosspad_capture 会通过开发板自身的 USB 音频端点录音，crosspad_analyze 会给出判定（起音、爆音、静音、力度曲线）。
“它为什么崩溃了？”	crosspad_diagnose_crash——复位原因、寄存器、根据实际刷入的 ELF 解码的回溯，以及重启后的堆状态。一次调用即可。
“我插入线缆时，监视一下电池充电器状态机。”	crosspad_trace 会通过 ST-Link 实时轮询 STM32 变量，不会暂停核心，并绘制变量图表。
“安装采样器应用并重新构建。”	crosspad_apps_install app_name=sampler 会从 crosspad-apps 注册表添加子模块，然后执行干净构建。
“IPadLogicHandler 是在哪里实现的？”	使用 crosspad_interface_implementations 搜索生态系统中的所有仓库，或使用 crosspad_symbol 查找 clangd 精确定位的定义和调用层级。
“我的开发板到底连上了吗？”	crosspad_devices 和 crosspad_doctor 会显示它处于哪种 USB 模式、哪些端口属于它、主机上缺少什么，以及如何逐项修复。

快速开始

claude mcp add crosspad -- npx -y crosspad-mcp-server

重启 Claude Code，然后询问：

我的 CrossPad 已连接吗？工具链配置好了吗？

这会运行 crosspad_doctor。每项未通过的检查都会附带一个 fix。服务默认认为你的仓库并排放在 ~/GIT/ 下——如果不是，请设置路径。

安装随附的 crosspad 技能后，Claude 就能预先了解生态系统概况、各角色指南和硬件相关的陷阱：

/plugin marketplace add CrossPad/crosspad-mcp
/plugin install crosspad@crosspad

组织方式

服务器启动时仅显示 core 工具集，因此工具列表会保持精简。Claude 会根据对话需要启用其他工具集——或者你也可以使用 --toolsets device,sim 启动服务器。

flowchart LR
    core["core · always on<br/>devices · doctor · snapshot<br/>build · flash · repo status · tasks<br/>bench lease"]
    sim["sim<br/>PC simulator: run, screenshot,<br/>input, MIDI, settings, tests"]
    device["device<br/>the board over USB: console,<br/>CDC verbs, UI driving, USB mode"]
    hil["hil<br/>scenarios, pad stimulus,<br/>audio capture + analysis, BLE"]
    code["code<br/>symbols, interfaces,<br/>docs search"]
    git["git<br/>submodule drift,<br/>update, commit"]
    apps["apps<br/>crosspad-apps registry"]
    trace["trace<br/>SWD live variables"]
    core --> sim & device & code & git & apps
    device --> hil
    core --> trace

任何会写入设备或主机的操作都分级管理。刷写、DFU 和 SWD 写入会先返回 需要确认；--read-only 则会从列表中完全移除所有写入工具。长时间运行的操作（构建、刷写、场景）会作为任务运行，你可以查看、等待或取消这些任务。

适用对象

• 你构建并操控 CrossPad 固件——主要使用模拟器，有时也使用开发板。请从用户指南开始。
• 你负责固件开发——刷写、控制台、HIL 场景、崩溃诊断、SWD。请阅读固件开发者指南和 HIL 测试。
• 你想扩展此服务器——请参阅贡献者指南和开发部分。

深入了解

• 使用参考——所有安装方式、每种工具和工具集、资源和提示词、配置、HTTP 传输，以及 v10 迁移表。
• 常见问题——那些会让人花上一下午的问题。
• 变更日志

许可证

GPL-3.0-or-later——详见 LICENSE。属于 CrossPad 项目。 版本最高至 10.3.0 的发行版均以 MIT 许可证发布。