Crosspad Mcp

io.github.CrossPad由 GitHub 帳號 CrossPad 發布v4.0.1更新於 Oct 24, 2026

Development workflow server for CrossPad — build, test, run, screenshot, and navigate code

已驗證STDIO僅桌面開發者工具AI 與機器學習

概覽

AI 產生的概覽

本機 MCP 伺服器，讓助理透過 ESP-IDF 與 STM32 工具鏈建置、燒錄、模擬、測試並診斷 CrossPad 打擊墊控制器的韌體。

可以做什麼
建置、燒錄並安裝韌體與應用程式，包括 OTA 上傳與從 crosspad-apps 登錄檔安裝子模組，長時間操作以可查詢的工作執行。執行 PC 模擬器、截取 LCD 畫面、送出打擊墊與編碼器輸入，並操作 MIDI 與設定。透過 USB 操作開發板：主控台、CDC 指令、介面驅動、USB 模式與裝置檢查。執行硬體迴路情境、打擊墊刺激、USB 音訊擷取與分析以及 BLE 測試。診斷當機，並透過 ST-Link 在不暫停核心的情況下即時追蹤 STM32 變數。在整個生態系中查找符號、介面實作與文件，並檢查子模組漂移與提交。
適用情境
適合開發 CrossPad 韌體或應用程式、希望讓助理代為執行建置、燒錄、模擬器工作階段、硬體迴路測試與當機診斷的人。也適合在多個儲存庫間瀏覽 CrossPad 程式碼庫。
執行需求
透過 npx 以 crosspad-mcp-server npm 套件在本機以 stdio 執行，僅限桌面。需要 CrossPad 工具鏈（ESP-IDF、STM32/ST-Link、clangd），硬體相關工具還需連接開發板。除非設定路徑，否則假定各儲存庫並列位於 ~/GIT/ 下。未宣告 API 金鑰或環境變數。
安裝前請注意
工具會寫入裝置與主機：燒錄、DFU 與 SWD 寫入會先要求確認，唯讀模式會移除所有寫入類工具。建置、燒錄與情境會改動韌體與儲存庫，應用程式安裝會加入子模組。硬體工具需要實際連接的開發板。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Crosspad Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

crosspad-mcp

[npm] [M8ven Live Monitored] [CI] [node] [license: GPL-3.0-or-later]

Talk to your CrossPad. Let Claude do the toolchain.

crosspad-mcp is an MCP server that teaches Claude Code (or any MCP client) how to develop for the CrossPad pad controller. You say "flash the new build and check that it boots"; it runs the ESP-IDF build, asks you to confirm the flash, opens the console, runs the smoke scenario and tells you what happened — with the hardware traps already built in, so you don't have to remember which serial port reboots the board when you open it.

[You prompt Claude Code, Claude Code talks MCP to crosspad-mcp, crosspad-mcp drives the PC simulator over TCP, the CrossPad board over USB and the STM32 co-processor over ST-Link]

What you can do with it

Every card is a real prompt. The tools named underneath are what runs — you never have to call them yourself.

Say this……and this happens
"Build the firmware and flash it over OTA."crosspad_build platform=idf streams the build, crosspad_flash transport=ota asks for confirmation, then streams the upload. New app directories are detected and the fullclean is done for you.
"Show me what's on the simulator screen."crosspad_run launches the PC sim, crosspad_screenshot returns the LCD as an image Claude can actually look at. Then "press pad 5", "turn the encoder left twice" — crosspad_input.
"Play a drum pattern on the pads and record what comes out."crosspad_stimulus hits the pads with real timings, crosspad_capture records the board through its own USB-audio endpoint, crosspad_analyze gives a verdict (onsets, clicks, silence, velocity curve).
"Why did it crash?"crosspad_diagnose_crash — reset reason, registers, backtrace decoded against the ELF that is actually flashed, heap after restart. One call.
"Watch the battery charger state machine while I plug the cable in."crosspad_trace polls STM32 variables live over ST-Link without halting the core, and plots them.
"Install the sampler app and rebuild."crosspad_apps_install app_name=sampler adds the submodule from the crosspad-apps registry, then a clean build.
"Where is IPadLogicHandler implemented?"crosspad_interface_implementations across every repo of the ecosystem, or crosspad_symbol for clangd-precise definitions and call hierarchies.
"Is my board even connected?"crosspad_devices and crosspad_doctor — which USB mode it is in, which ports belong to it, what is missing on the host, and how to fix each thing.

Quick start

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

Restart Claude Code, then ask:

is my CrossPad connected, and is the toolchain set up?

That runs crosspad_doctor. Every failed check comes with a fix. The server assumes your repos live side by side under ~/GIT/ — if they don't, set the paths once.

Installing the bundled crosspad skill gives Claude the ecosystem map, the per-role guides and the hardware traps up front:

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

How it is organised

Only the core toolset is visible when the server starts, so the tool list stays small. Claude enables the others as the conversation needs them — or you start the server with --toolsets device,sim.

mermaid
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

Anything that writes to a device or your host is tiered. Flashing, DFU and SWD writes come back as confirmation required first; --read-only removes every writing tool from the list entirely. Long operations (builds, flashes, scenarios) run as tasks you can check on, wait for or cancel.

Who is it for

Going deeper

  • Usage reference — every install path, every tool and toolset, resources and prompts, configuration, HTTP transport, the v10 migration table.
  • FAQ — the questions that cost people an afternoon.
  • CHANGELOG

License

GPL-3.0-or-later — see LICENSE. Part of the CrossPad project. Releases up to 10.3.0 were published under MIT.

來源：README.md，提交 50e2263

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v4.0.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分