Skip to content

MCP:AI 直接操作设备 ​

PicoXTools 在板上提供 MCP Streamable HTTP 服务。AI 客户端连接 http://192.168.33.1/mcp/api,旧拼写 /mpc/api 也兼容。不需要电脑启动本地硬件桥接。

此页包含最新工程已注册的工具;旧固件不一定具备新增 DAP。实际以连接后的 tools/list 为准,不把网页上的所有功能都当作已存在 MCP 工具。

建立会话 ​

向同一地址 POST JSON-RPC:

json
{"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,再调用:

json
{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}

会话结束时 DELETE 同一地址并携带会话头。固件当前使用 JSON 响应,不要求客户端依赖持续 SSE 通知。

GPIO / I2C / SPI / UART ​

工具参数
gpio.openpin, dir=1, level=1;dir=0 输入、1 输出
gpio.getpin
gpio.setpin, level
i2c.opensda=4, clk=5, speed=400000, reg-width=1;寄存器宽度 1–4
i2c.close / i2c.scan{}
i2c.readaddr, len,可选 reg
i2c.writeaddr, data(Base64),可选 reg
spi.openclock=1000000, bits=8, cpol_cpha=0
spi.close{}
spi.readlen
spi.writedata(Base64)
uart.openbitrate=115200, tx_pin=4, rx_pin=5, data_bits=8, stop_bits=1, parity=0
uart.close{}
uart.readlen, timeout=0(毫秒)
uart.writedata(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.infoid=2(产品信息)完整响应字节数组
dap.executecommands:1–32 个完整命令数组,每项最多 64 字节顺序对应的 responses
dap.read32address,可选 ap=0, frequency=1000000无符号 value 与小端 data
dap.write32address, value,可选 ap, frequencybytesWritten
dap.readMemoryaddress, length(1–256),可选 ap, frequency字节数组 data
dap.writeMemoryaddress, data(1–256 个数字字节),可选 ap, frequencybytesWritten

四个内存便捷接口自动初始化 SWD MEM-AP,不自动暂停 MCU,调用后释放接口。32 位访问须对齐。写内存用于 RAM/MMIO,不是 Flash 烧录算法;外围寄存器读写可能有硬件副作用。

读 Cortex-M CPUID:0xE000ED00 在 JSON 中写十进制 3758157056:

json
{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"dap.read32","arguments":{"address":3758157056}}}

写入 RAM(先确认该区域可用):

json
{"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 时钟后断开,不扫描或写目标:

json
{"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 方法名。