MCP:AI 直接操作设备
PicoXTools 在板上提供 MCP Streamable HTTP 服务。AI 客户端连接 http://192.168.33.1/mcp/api,旧拼写 /mpc/api 也兼容。不需要电脑启动本地硬件桥接。
此页包含最新工程已注册的工具;旧固件不一定具备新增 DAP。实际以连接后的 tools/list 为准,不把网页上的所有功能都当作已存在 MCP 工具。
建立会话
向同一地址 POST JSON-RPC:
{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"my-client","version":"1.0"}}}保存响应头 Mcp-Session-Id,后续请求带该值和 MCP-Protocol-Version: 2025-06-18。发送 notifications/initialized,再调用:
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}会话结束时 DELETE 同一地址并携带会话头。固件当前使用 JSON 响应,不要求客户端依赖持续 SSE 通知。
GPIO / I2C / SPI / UART
| 工具 | 参数 |
|---|---|
gpio.open | pin, dir=1, level=1;dir=0 输入、1 输出 |
gpio.get | pin |
gpio.set | pin, level |
i2c.open | sda=4, clk=5, speed=400000, reg-width=1;寄存器宽度 1–4 |
i2c.close / i2c.scan | {} |
i2c.read | addr, len,可选 reg |
i2c.write | addr, data(Base64),可选 reg |
spi.open | clock=1000000, bits=8, cpol_cpha=0 |
spi.close | {} |
spi.read | len |
spi.write | data(Base64) |
uart.open | bitrate=115200, tx_pin=4, rx_pin=5, data_bits=8, stop_bits=1, parity=0 |
uart.close | {} |
uart.read | len, timeout=0(毫秒) |
uart.write | data(Base64) |
I2C 地址为 7 位;多字节寄存器地址按 reg-width 大端发送。CPOL/CPHA 0–3 对应 (0,0)/(0,1)/(1,0)/(1,1)。UART parity 0/1/2 对应 None/Even/Odd。
gpio.open 默认主动驱动高电平;仅观察输入时显式 dir:0。没有 gpio.close 工具。当前 I2C 长度在 handler 内转换为 uint8,不要传 256 或更大,建议从 1–64 字节小读开始;SPI/UART 文本化读取最多展示 256 字节,不用它们做完整大文件备份。
Base64 示例:字节 01 02 0D 0A 对应 AQINCg==。
DAP 工具
| 工具 | 参数 | 返回内容 |
|---|---|---|
dap.info | id=2(产品信息) | 完整响应字节数组 |
dap.execute | commands:1–32 个完整命令数组,每项最多 64 字节 | 顺序对应的 responses |
dap.read32 | address,可选 ap=0, frequency=1000000 | 无符号 value 与小端 data |
dap.write32 | address, value,可选 ap, frequency | bytesWritten |
dap.readMemory | address, length(1–256),可选 ap, frequency | 字节数组 data |
dap.writeMemory | address, data(1–256 个数字字节),可选 ap, frequency | bytesWritten |
四个内存便捷接口自动初始化 SWD MEM-AP,不自动暂停 MCU,调用后释放接口。32 位访问须对齐。写内存用于 RAM/MMIO,不是 Flash 烧录算法;外围寄存器读写可能有硬件副作用。
读 Cortex-M CPUID:0xE000ED00 在 JSON 中写十进制 3758157056:
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dap.read32","arguments":{"address":3758157056}}}写入 RAM(先确认该区域可用):
{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"dap.writeMemory","arguments":{"address":536870912,"data":[120,86,52,18]}}}注意 DAP 的 data 是数字数组,不同于上述总线 MCP 工具的 Base64。
原始 CMSIS-DAP 事务
下面只配置 JTAG 时钟后断开,不扫描或写目标:
{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"dap.execute","arguments":{"commands":[[2,2],[17,64,66,15,0],[3]]}}}每个数组含命令号。请求及最大响应必须满足 64 字节限制,沿用板端命令验证;支持该路径已实现的 Info、Connect/Disconnect、Transfer、SWJ、SWD/JTAG 时序、SWO/UART 和 ExecuteCommands。返回原始结果,不自动解释每个 ACK,也不自动重试失败指令。
原始工具可发标准 SWD/JTAG;RVSWD 不是 CMSIS-DAP。调用结束会自动 Disconnect,所以不能把 Connect 与后续 Transfer 拆在不同 MCP 调用。需放在一次 dap.execute 中完成整个事务。QueueCommands 0x7E 和未知 vendor 指令不接受。
错误与清理
DAP 使用异步状态机,硬件操作由 DAP 工作任务执行。每次调用独占完整事务,结束、失败、断线或 5 秒超时后发起清理;工作任务完成退出前不把接口交给其他入口。忙时 isError: true,文本给出 owner=...,例如 gdb、web_rtt、usb_cmsis_dap、script、mcp。
HTTP 200 不等于操作成功。检查 JSON-RPC error、result.isError 和工具文本;普通总线旧工具的部分业务错误仍以文本报告。原始 DAP 还需检查状态、ACK 和完成数。超时写入可能已经部分生效,不自动重放。
MCP DAP 每次调用自动释放,不需要额外 dap.close。I2C/SPI/UART 仍需调用自己的 close;DELETE MCP 会话不会代替关闭这些总线。
当前能力范围
Shell、FlashRom、完整 MCU 烧录、RTT 与采集尚未在此 MCP 注册表中提供专用工具;使用 独立 SDK 或对应网页。不要编造不存在的 MCP 方法名。