AI 客户端配置

服务器通过 stdio 使用 MCP 协议。标准配置方式是 npx 形式（运行已发布的 npm 包）；要运行本地构建的二进制，把 npx -y cmsis-dap-mcp 换成二进制路径即可，服务器行为完全一致。

配置方式

把 MCP 客户端指向服务器有三种写法：

方式	示例	适用场景
`npx` 包（标准）	`command = "npx", args = ["-y", "cmsis-dap-mcp"]`	已发布版本；首次启动下载并缓存
本地二进制	`command = "/path/to/cmsis-dap-mcp"`	未发布或本地构建、离线、精确版本
远程 URL	`url = "https://..."`	Streamable-HTTP MCP 服务器（本项目暂不支持）

用 npx 固定版本：npx -y cmsis-dap-mcp@0.5.0。开发本仓库时，把客户端指向 target/release/cmsis-dap-mcp，即可使用刚构建的二进制而无需发布。

服务器命令行参数

所有参数均可选——服务器零参数启动即可，进入待配置态。下表中除日志外的一切都可以在运行时通过 update_config / reload_config / get_config MCP 工具变更，无需重启。

参数	说明
`--allow-destructive`	启动即开启 `erase_flash` / `program_flash` 及破坏性脚本命令
`--tcp PORT`	同时在 `127.0.0.1:PORT` 提供远程 JSON-RPC TCP 服务
`--gdb-port PORT`	同时在 `127.0.0.1:PORT` 启动 GDB 服务器
`--config-file FILE`	JSON 配置文件（键：`allow_destructive`、`tcp_port`、`gdb_port`）；启动时加载，可监听变更
`--probe-id ID`	connect 的默认探针 id
`--protocol swd\|jtag`	默认调试协议（默认 `swd`）
`--speed-khz N`	默认 SWD/JTAG 时钟速度
`--target NAME`	默认目标芯片名
`--svd FILE`	启动时加载的 SVD 文件
`--target-yaml FILE`	预加载到芯片注册表的 target YAML
`--log-level LEVEL`	tracing 过滤器；日志写 stderr（默认 `info`）
`--log-file FILE`	日志写入文件而非 stderr

仅启动时固定（运行时不可变更）：--log-level、--log-file、 --config-file 路径本身（其内容可重载）、backend 注册表种子（--target-yaml；define_chip 在运行时往里追加）。GDB 服务器端口一旦启动即不可变更。

优先级：CLI 参数 > 配置文件 > 默认值；运行时 update_config 覆盖两者。

Codex

codex mcp add cmsis-dap -- npx -y cmsis-dap-mcp

或写入 ~/.codex/config.toml：

[mcp_servers.cmsis-dap]
command = "npx"
args = ["-y", "cmsis-dap-mcp"]

本地构建时用 command = "/path/to/cmsis-dap-mcp"。用 codex mcp list 确认；Codex 桌面端在新会话启动时加载该服务器。

Claude Code

claude mcp add --scope local cmsis-dap -- npx -y cmsis-dap-mcp

本地构建时把 npx -y cmsis-dap-mcp 换成二进制路径。用 claude mcp list 确认（显示 √ Connected）。

opencode

opencode mcp add cmsis-dap -- npx -y cmsis-dap-mcp

或写入 ~/.config/opencode/opencode.jsonc：

"cmsis-dap": {
  "type": "local",
  "command": ["npx", "-y", "cmsis-dap-mcp"],
  "enabled": true
}

本地构建时把 command 数组换成 ["/path/to/cmsis-dap-mcp", "--log-level", "warn"]。用 opencode mcp list 确认。

其他 MCP 客户端

{
  "mcpServers": {
    "cmsis-dap": {
      "command": "npx",
      "args": ["-y", "cmsis-dap-mcp"]
    }
  }
}

端到端示例（已实测）

以下任务已由 Claude Code 和 opencode 在真实 CMSIS-DAP 探针上成功执行：

1. list_probes
2. connect {protocol: swd, speed_khz: 1000}
3. read_memory {address: 0x20000000, width: u32, count: 4}
4. halt
5. read_core_register {name: pc}
6. resume

实测结果：

探针 id : 0123456789AB（CMSIS-DAP，vendor 0x0416）
内存    : [64000000, 1, 3, 0]
pc      : 134228884（0x08002B94）

说明：

模型传参时请使用十进制整数或字符串；部分客户端会拒绝 JSON 参数里的十六进制字面量（如 0x20000000）。十进制 536870912 等价。
connect、halt、resume 等写工具可能受客户端审批策略约束。
添加服务器后如果工具不出现，请重启客户端。

Keyboard shortcuts

CMSIS-DAP MCP