Crosspad MCP

crosspad mcp服务器

MCP（模型上下文协议）服务器，使Claude Code能够完全控制CrossPad开发工作流程——构建、测试、管理应用程序包、与模拟器交互、跨存储库搜索代码。都是自然语言。

安装

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

或者使用自定义仓库路径：

claude mcp add crosspad \
  --env CROSSPAD_IDF_ROOT=/path/to/platform-idf \
  --env CROSSPAD_PC_ROOT=/path/to/crosspad-pc \
  -- npx -y crosspad-mcp-server

就是这样。重新启动Claude Code，工具就可用了。

备选方案： .mcp.json 在您的项目中

添加到您的repo根目录中——Claude Code会自动拾取它：

{
  "mcpServers": {
    "crosspad": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "crosspad-mcp-server"],
      "env": {
        "CROSSPAD_IDF_ROOT": "/path/to/platform-idf",
        "CROSSPAD_PC_ROOT": "/path/to/crosspad-pc"
      }
    }
  }
}

替代方案：克劳德桌面

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "crosspad": {
      "command": "npx",
      "args": ["-y", "crosspad-mcp-server"],
      "env": {
        "CROSSPAD_IDF_ROOT": "/path/to/platform-idf"
      }
    }
  }
}

工具（28）+资源

v8统一了平台轴工具：构建/运行/杀死/检查/flash立即获取 platform （或 transport)作为arg，而不是按平台拆分。此文件底部的迁移表。

每个工具都专注于一个动作。严格的模式验证（MIDI/pad值的范围，平台/repos上的枚举）在执行前捕获错误的输入。

构建和闪存

测试

模拟器交互

Git/仓库

代码搜索和脚手架

应用程序包管理器（跨广告应用程序注册表）

资源

迁移：v7→ v8

平台/传输现在作为arg流动，而不是作为工具名称的一部分。净值：30→ 28 工具。

运行/杀死/检查今天只适用于PC（ platform arg是为将来的对称性保留的——IDF固件不在主机上运行）。构建模式按平台进行验证： reconfigure 仅限于PC； fullclean 只有IDF。

迁移：v6→ v7

工具已移除（逻辑已移至文档）： crosspad_scaffold_app, crosspad_test_scaffold. 工具整合：

净值：42工具→ 30 工具+1资源（v7）。v8中的后续统一→ 28 工具（见上文）。

所有工具都返回一个统一的信封： { "success": boolean, ...data, "error"?: string }失败时，结果也有MCP协议 isError: true 设置标志，以便客户端可以将错误与成功呼叫区分开来。

每个工具都携带 MCP注释 (readOnlyHint, destructiveHint, openWorldHint)--客户端将这些用于确认提示。只读工具（状态、搜索、列表）跳过提示；破坏性工具（commit、flash、build_idf clean、apps_install）会触发一个。

配置

每个repo路径都可以通过env-vars单独配置。如果未设置，则回退到 $CROSSPAD_GIT_DIR/ （平面布局）。

存储库是动态发现的——只有磁盘上存在的存储库才会出现在工具结果中。设置env变量时，不假定有平面目录结构。

运输

stdio（默认） — npx crosspad-mcp-server克劳德代码/Claude桌面/IDE插件的标准MCP传输。

HTTP(--http ) — npx crosspad-mcp-server --http 3000。在以下位置公开可流式传输的HTTP端点 http://localhost: /mcp 用于远程开发箱或基于浏览器的MCP客户端。有意义的会议(Mcp-Session-Id 头球在后面回响 initialize).一次传输，内部多路复用多会话。

# Minimal HTTP smoke test:
npx crosspad-mcp-server --http 3000
curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"x","version":"0"}}}'

运作原理

静态工具 （构建、存储库、代码、应用程序）在没有模拟器的情况下工作——它们在文件系统、git和Python包管理器上运行。

交互式工具 （sim）通过TCP与正在运行的PC模拟器通信 localhost:19840 使用换行符分隔的JSON。

流媒体 --长时间运行的工具（构建、测试、日志）通过MCP日志逐行发出输出，因此Claude可以实时看到进度。

应用程序管理器 --直接读取注册表JSON以进行列表（在所有存储库中聚合）。突变委托给 app_manager.py （at tools/ 对于IDF， scripts/ 适用于PC/Arduino） 跨广告应用程序.

发展

git clone https://github.com/CrossPad/crosspad-mcp.git
cd crosspad-mcp
npm install
npm run dev      # watch mode
npm run build    # one-shot build
npm test         # run unit tests
npm run test:watch  # tests in watch mode

src/
  index.ts              — 41 focused tool registrations (one tool per action)
  config.ts             — per-repo env vars, dynamic discovery, IDF/MSVC paths
  config.test.ts        — config unit tests (fs mocking)
  utils/
    exec.ts             — platform-aware command execution (MSVC/IDF/shell)
    git.ts              — repo status, submodule pins
    remote-client.ts    — TCP client for simulator (localhost:19840)
  tools/
    app-manager.ts      — crosspad_apps: multi-platform registry + Python subprocess
    architecture.ts     — interfaces, REGISTER_APP scan
    build.ts            — PC build + run
    build-check.ts      — build health check
    diff-core.ts        — submodule drift analysis
    idf-build.ts        — ESP-IDF build
    input.ts            — simulator input events
    log.ts              — exe log capture
    repos.ts            — multi-repo git status
    scaffold.ts         — app boilerplate generation
    screenshot.ts       — simulator screenshots
    settings.ts         — simulator settings R/W
    stats.ts            — simulator runtime stats
    symbols.ts          — cross-repo symbol search
    test.ts             — Catch2 test runner
    *.test.ts           — unit tests for each module

许可证

麻省理工学院—— CrossPad 项目。