mcu-debug-mcp

Name: mcu-debug-mcp
Author: stillsurge

作者：stillsurge版本 0.1.1i★ –i在你的电脑上运行

注册名称io.github.stillsurge/mcu-debug-mcp

安装

概览

作者提供的说明（英文原文）

Embedded debug MCP: serial, flash verify, fault decode, 45-pattern log analyzer, driver library

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i尚未统计★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 其他

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： MCU_DEBUG_MCP_MODE, MCU_DEBUG_MCP_PORT_DENY

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "mcu-debug": {
      "command": "uvx",
      "args": [
        "mcu-debug-mcp"
      ],
      "env": {
        "MCU_DEBUG_MCP_MODE": "your-value",
        "MCU_DEBUG_MCP_PORT_DENY": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add mcu-debug --env MCU_DEBUG_MCP_MODE=your-value --env MCU_DEBUG_MCP_PORT_DENY=your-value -- uvx mcu-debug-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcu-debug": {
      "command": "uvx",
      "args": [
        "mcu-debug-mcp"
      ],
      "env": {
        "MCU_DEBUG_MCP_MODE": "your-value",
        "MCU_DEBUG_MCP_PORT_DENY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "mcu-debug": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcu-debug-mcp"
      ],
      "env": {
        "MCU_DEBUG_MCP_MODE": "your-value",
        "MCU_DEBUG_MCP_PORT_DENY": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

MCU_DEBUG_MCP_MODE env
Isolation mode: readonly (default) or write. Controls whether serial write/flash operations are allowed
MCU_DEBUG_MCP_PORT_DENY env
Comma-separated port denylist (e.g. COM6,COM28); supports * wildcard; DENY overrides ALLOW

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 stillsurge 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“其他”中的其他服务器比较i

星标数多于此分类中其他 18353 个服务器的 0%
发布到注册中心的时间比此分类中其他 18353 个服务器的 73% 更新
基础检查结果等于或优于此分类中其他 18353 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

mcu-debug-mcp 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.1）于15天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Spec Driven Development, Remote Desktop Commander, Date Math

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

在你的电脑上运行★ 440MIT14个月前更新

安装

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

在云端运行★ 211前天更新

安装

Date Math

作者：JowenDelaPena

Date/time math for agents: business days, holidays, time zones, cron, RRULE. 25 free calls/day.

电脑或云端今天更新

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

mcu-debug-mcp · 嵌入式调试 MCP（领域级）

让 AI"看到并看懂"你手上的板子：串口读写 + 故障模式库（45 条规则）+ 烧录失败模式直译 + Modbus 帧解析 + 编译报错解析 + 引脚冲突检测（三引擎）+ 板级知识库 + 波特率自动探测 + AT 序列回归 + 双口对录 + 会话持久化 + RTT 通道 + 烧录桥接 + 寄存器位域解码 + 调试器探测 + 预验证驱动模板库（9 款）+ 器件选型库（按接口/地址/时序要求） + 外设 API 用法层（初始化顺序硬要求） + 错误码统一查询（6 张表·带出处） + 报文解析（自定义二进制帧 / NMEA-GPS） + 工程结构与工具链探测 + 会话日志治理与交付报告。共 59 个工具 + 16 个 MCP resources + 6 个 prompts（8 静态 resources + 8 模板 resources）。

和"直接问 AI"的本质区别：AI 不再听你转述"传感器好像不太对"，而是亲自读到串口里的真实字节——AT 指令返回了什么、数据是全 0 还是乱码、程序是不是在反复重启、Keil 为什么烧不进去——然后按出厂预置的故障模式库给出诊断和排查步骤。引脚分配前用数据手册级映射表核对（能抓 AI 幻觉接线）。驱动代码来自验证过的模板库（纯函数 PC 可测 + Python 交叉验证），不是 AI 现编的。

安全与隔离：默认不碰硬件

这个 MCP 的工具会真的打开串口、写字节、烧 flash。开发机上常年挂着正在使用的设备（UART 桥、调试器 CDC 口、正在跑的调试会话），一次误调用就能打断它们。所以默认档位是只读：

项	默认	说明
隔离档位	readonly	读/枚举允许；写串口、AT、波特率扫描、双口对录、烧录一律拒绝，并在拒绝信息里写清「为什么拒 + 什么风险 + 怎么放开」
端口名单	未设置	`MCU_DEBUG_MCP_PORT_DENY=COM6,COM28` 把你在用的口锁死（支持 `*` 通配，DENY 优先于 ALLOW）
不可逆操作	双闸门	烧录要 `dry_run=False` 且 `confirm=True` 才会写 flash；只给预览
测试隔离	强制	测试进程锁 readonly + 端口全禁 + 真实串口构造被替换；跑测试不会碰你的设备

MCU_DEBUG_MCP_MODE=write              # 放开写权限（做真机操作时）

MCU_DEBUG_MCP_PORT_DENY=COM6,COM28 # 把在用的口锁死（即使放开了写权限也打不开） MCU_DEBUG_MCP_NO_TOUCH_DTR=1 # 打开端口时不翻转 DTR/RTS，尽量不触发开发板自动复位

完整的风险矩阵（每个操作会做什么、需要什么才能执行、哪些操作没纳入闸门及原因）见 [`SECURITY.md`](SECURITY.md)。随时可用 env_status 查当前档位、名单与「因此被禁用了哪些操作」。

与同类工具的差异（2026-09 竞品调研结论）

同类串口 MCP（qarnet/serial-mcp、mcp-serial、uart-mcp 等）只做「串口通道」；本项目的差异化在知识层：

能力	串口通道类 MCP	本项目
串口读写	✅（普遍更全）	✅ expect 模式等待响应
日志分析	❌ 把原始日志丢给 LLM 现看	✅ 45 条模式库（30 内置 + 15 外置），规则出厂预置+带排查步骤
烧录失败诊断	❌	✅ ST-Link 连接失败/Keil 找不到算法/esptool 进不了下载模式/RDP 读保护…8 条规则族
错误码查询	❌	✅ error_code_lookup：ESP-IDF esp_err_t / ESP-AT 通用响应 / CWJAP / CME / PubSubClient rc / Modbus 异常码，共 6 张表 51 条，每条带出处；未收录明说查不到
编译/链接报错解析	❌	✅ gcc / Keil / armcc / MSVC 四种风格
引脚冲突检测	❌	✅ pin_check 三引擎：F1 固定复用 / F4 AF 表 / ESP32 io_mux 硬约束，可交叉板载外设
板级知识库	❌	✅ board_get：板载外设占用+坑清单按翻车率排序+供电说明（蓝药丸/黑药丸已收录）
会话持久化	❌	✅ 串口会话自动落盘 logs/，隔多少轮对话都能 sessions_list + sessions_get 回看现场
波特率自动探测	❌	✅ baudrate_autodetect 逐档评分排序（支持离线日志样本评分）
AT 批量回归	❌	✅ at_sequence 逐条断言 PASS/FAIL + serial_pair_record 双口对录时间线
预验证驱动库	❌	✅ 9 款，纯函数分离+交叉验证+坑清单+答辩加分点
寄存器位域解码	embedded-mcp 有	✅ 支持手工 fields + CMSIS-SVD 文件
RTT 通道	❌	✅ rtt_read（pyocd 桥接，实验性）
知识库质量保障	❌	✅ validate_knowledge.py 机械核验（引脚数/唯一性/复用唯一/正则可编译），CI 可挂
知识库可扩展	❌	✅ 故障模式/错误码表/引脚映射/板级知识全部 JSON 外置，社区可贡献（逐条标 source）

工具清单（59 个）

工具	功能	依赖
serial_list	枚举串口，识别 CH340/CP2102/FT232 并给驱动建议	pyserial
serial_open / serial_close	打开/关闭串口（返回句柄；会话日志自动落盘，落点见 env_status）	pyserial
serial_read	读数据（expect 正则命中即返回 + idle_ms 静默超时 + 总超时），文本+HEX 双视图	pyserial
serial_send	发指令（AT 自动加 \r\n；支持 HEX；expect 等响应），自动读回	pyserial
serial_session_log	取全量会话日志	pyserial
sessions_list	列出已落盘会话日志（新→旧），隔轮次可回看	无
sessions_get	回看指定会话日志内容（默认尾部 200 行），可喂 analyze_log	无
logs_prune	会话日志保留策略与清理入口（默认 dry-run 只列不删；真删需 write 档 + confirm=True）	无
baudrate_autodetect	波特率自动探测：逐档采样评分排序给推荐（log_text 可离线评分）	pyserial
at_sequence	AT 指令序列批量回归：逐条正则断言 PASS/FAIL/TIMEOUT + 回显尾	pyserial
serial_pair_record	双口对录：两串口时间线交错录制（RS485 主从/双机对话），文本+HEX	pyserial
analyze_log	45 条故障模式分析（见下），每条给人话诊断+排查步骤	无
modbus_crc	Modbus RTU CRC16 计算/校验（RS485 毕设）	无
modbus_parse	Modbus RTU 帧解析：拆寄存器值/线圈，异常响应直译异常码 01-06	无
error_code_lookup	错误码统一查询（esp_idf / at_common / cwjap / cme / modbus_exception / mqtt_rc）：释义+排查方向+出处；未收录明说查不到、不猜	无
pin_check	引脚冲突检测（三引擎）：幻觉接线/同功能双占/SWD 挪用/remap 档/ESP32 硬约束/板载外设交叉	无
pinmap_list / pinmap_get	引脚知识库浏览（列表 / JSON 原文）	无
board_list / board_get	板级知识库：板载外设+坑清单+供电说明（bluepill / blackpill_f411 / esp32_devkitc32）	无
probe_list	探测调试器与目标芯片	pyocd（可选）
rtt_read	RTT 通道读日志（⚠ 实验性，固件需含 SEGGER RTT 控制块）	pyocd（可选）
flash_tool_detect	检测本机烧录工具	无
flash_firmware	烧录固件，桥接 STM32_Programmer_CLI/esptool/st-flash/pyocd，默认 dry-run；烧完自动复位	各工具（可选）
driver_list / driver_get	预验证驱动模板库（9 款，含接线表+验证记录）	无
driver_wiring	驱动接线知识库：接线表+头号坑+日志解读+答辩加分点	无
component_list / component_get	器件选型库：按接口（i2c / uart / timer_pwm / gpio_timing）列器件，带 7 位地址、微秒时序要求、头号坑、出厂验证记录；数据全部派生自预验证驱动库的 meta.json 与 _port.h，零凭记忆条目*	无
peripheral_api_list / peripheral_api_get	外设 API 用法层：每个驱动要占哪些外设（I2C1 / TIM1 / UART2…）+ 初始化顺序硬要求（取自适配层注释原句，如「工程里先完成 HAL_I2C_MspInit 与 hi2c1 初始化」）	无
decode_register	寄存器值按位域拆解	无
decode_register_svd	按 CMSIS-SVD 文件解码位域（含枚举提示）	无
decode_fault	Cortex-M 故障寄存器解码（CFSR/HFSR/BFAR/MMFAR）：20 位逐条给人话成因+排查；三类陷阱在输出里强制拦截（见下）	无
parse_map	.map 解析（GNU ld / Keil / IAR）：段占用 + 最大符号 + 栈深线索；认不出格式就说认不出，不猜；主机 map 会报警	无
symbol_lookup	地址→符号反查：给出函数名+偏移；越界/落在空隙/野指针拒绝硬套函数名	无
stack_unwind	栈回溯：硬件 8 字栈帧还原调用链 + EXC_RETURN 判栈类型（MSP/PSP、标准/扩展帧）+ 跑飞识别	无
env_status	环境自检：依赖 / 串口（含 VID:PID 识别与 Unix 权限）/ 烧录器 / 知识库根与条目数 / 版本，一次问清；探不到的会明说为什么探不到	无
ecosystem_list / ecosystem_get	生态/框架识别知识库（Zephyr / RT-Thread / PlatformIO / Keil / IAR / Rust defmt）：识别特征 + 构建产物 + 日志签名 + 各自的坑，条目级带出处	无
project_detect	工程结构识别：按标志文件/后缀认生态（`platformio.ini` / `.uvprojx` / `prj.conf` / `Cargo.toml`…），只探一层*（避免 vendor/ 误判）；认不出明说该看什么	无
toolchain_status	工具链探测：编译器 / GDB / SDK 逐个探版本；「未发现」不等于环境坏了——会说明 IDE 自带工具不一定暴露到命令行	无
report_session	交付物生成：会话日志 → Markdown 报告（故障分析 + 原始日志附后）；目标已存在不默认覆盖	无
nmea_parse	NMEA 0183 解析（GPS/北斗）：GGA/RMC/GSA/GSV/VTG/GLL 逐句给人话（经纬度度分+十进制/定位质量/星数/HDOP/速度）；每句验 XOR，不过的明说不可信；非 NMEA 行单独点名跳过	无
frame_parse	通用二进制帧解析：帧头 + 长度字段切帧，支持 sum8 / CRC16-Modbus；校验字节不计入长度字段（Modbus 就靠这条）；切不动/截断/垃圾字节逐条报出，绝不静默丢	无
chip_info	芯片身份与存储信息：型号 / Device ID / 修订 / 内核类型 / Flash 容量 / 96 位 UID / 选项字节（读保护、TZEN、写保护组）；默认 hotplug 档不复位不停内核，要 UID 得显式 `mode="full"`（会复位目标，受隔离层管辖）	STM32_Programmer_CLI
reset_reason	复位原因 + 内核运行状态：RCC_RSR 逐位直译（引脚/欠压/软件/看门狗/低功耗）并给可执行建议；讲清标志是「累积」的——多个位同时为 1 ≠ 一次同时发生；`clear_flags+confirm` 支持「清 → 复现 → 再读」定位这一次	STM32_Programmer_CLI
flash_verify	烧录后逐字节校验：把文件与芯片上实际内容比对，报出首个不一致的偏移 + 绝对地址 + 前后 8 字节上下文；支持 .bin / .hex / .elf（ELF 按段表偏移取值）；只读走 hotplug	STM32_Programmer_CLI
timing_analysis	时序/数据率分析：丢帧（序号跳号）、卡顿（间隔离群）、节拍漂移（累计变化量 vs 实际离散度）；窗口不足一个时间戳刻度时明说不给指标，不编数据率	无

总线工具需要一块跑 MCUDBG/1 桥固件的 MCU 当执行端：固件源码在 tools/bridge_fw/

（NUCLEO-H563ZI 现成，附"编译 → 烧录 → 真机验证 → 自动恢复原固件"一条龙脚本）。

为什么不自动扫串口找桥、为什么 SP-Link bridge 和 FT2232H 走不通，见 core.py 总线工具区块头注释。 |

MCP resources（16 个：8 静态 + 8 模板）

知识库只读浏览，AI 可主动引用——每类知识都是「清单 + 明细」两段：清单看有哪些，明细读原文（条目级 source 出处一并可见）。

知识库	清单	明细
预验证驱动	`mcu://drivers`	`mcu://driver/{name}` · `mcu://wiring/{name}`（接线）
器件选型库	`mcu://components`	`mcu://component/{name}`（选型详情+接线坑）
外设 API 用法	`mcu://peripheralapis`	（取自各驱动 `*_port.h`，随驱动走，无独立明细资源）
引脚复用映射	`mcu://pinmaps`	`mcu://pinmap/{mcu}`（pinmap JSON 原文）
板级知识	`mcu://boards`	`mcu://board/{name}`
错误码直译表	`mcu://errcodes`	`mcu://errcode/{table}`（整表 JSON 原文）
故障位域表	`mcu://faultbits`	`mcu://faultbits/{arch}`（如 `cortex_m`，两种写法都认）
生态/框架识别	`mcu://ecosystems`	`mcu://ecosystem/{name}`（如 `keil`、`rtthread`，显示名模糊匹配）

pin_check 三引擎

engine	适用	检查逻辑
fixed_mux	F1 系列（stm32f103c8t6）	固定复用表：功能默认档全局唯一，remap 档提示，SWD 挪用警告
af_table	F4 系列（stm32f411ceu6）	AF 复用表：一功能可映射多脚，按表核对
io_mux	ESP32 系列（esp32dev）	GPIO Matrix 任意路由，查硬约束：flash 保留脚（GPIO6-11，必砖级）/ 仅输入脚（GPIO34-39）/ strapping 脚（0/2/5/12/15）

可带 board 参数交叉检查板载外设占用（如 pin_check("stm32f103c8t6", {...}, board="bluepill")——PC13 被板载 LED 占用会警告）。

analyze_log 覆盖的模式（45 条）

内置 30 条：

总线/传感器层（13）：MOJIBAKE 乱码→波特率 · AT_ERROR · AT_NO_RESP · BOOT_LOOP · HARDFAULT+CFSR 位级解读 · SENSOR_ZERO 全 0 · SENSOR_FF 全 FF · DS18B20_85 恒 85°C · DHT_TIMEOUT · NEG_INVALID 错误码负值 · I2C_NACK · I2C_SCAN_EMPTY 扫描零设备 · ADC_SATURATED 恒满量程

ESP 生态（5）：ESP_PANIC Guru Meditation · ESP_BROWNOUT 掉电 · ESP_WDT 看门狗 · ESP_FLASH_CORRUPT 镜像损坏 · CWJAP_ERR 连 WiFi 错误码 1-4

AT/网络协议（4）：AT_CME_ERROR（3GPP 码表）· NET_LINK WiFi 断链 · MQTT_FAIL（PubSubClient rc 码表）· HTTP_ERR 4xx/5xx/curl

RTOS/系统层（4）：RTOS_ASSERT 断言 · RTOS_STACK_OVF 栈溢出 · HAL_ASSERT STM32 HAL 参数断言 · UART_FRAMING 帧错误/溢出

开发期报错（3）：COMPILE_UNDEF 链接未定义符号 · COMPILE_SYNTAX 编译错误（gcc/Keil/armcc/MSVC）· SD_INIT_FAIL

外置 15 条（knowledge/fault_patterns.json，社区可贡献）：

烧录失败族（8）：STLINK_CONNECT_FAIL · KEIL_NO_ALGO 找不到 Flash 算法 · KEIL_FLASH_DL_FAIL 下载失败 · OPENOCD_TARGET_FAIL · ESPTOOL_FAIL 进不了下载模式 · PYOCD_PROBE_FAIL · FLASH_READOUT_PROTECT 读保护激活 · SWD_COMM_FAIL 调试中失联
总线/网络族（6，v4 新增）：CAN_BUS_OFF（bus-off/error passive，终端电阻 60Ω/ACK 原理）· WIFI_RECONNECT_STORM（断连 ≥3 次计数门槛，供电头号原因）· BLE_CONN_LOST（连接参数/MTU/断开原因码 0x08/0x13）· JLINK_FAIL（克隆许可/DLL 冲突）· DNS_FAIL（DNS 配置/内网域名）· USB_ENUM_FAIL（DP 1.5kΩ 上拉/48MHz 晶振/R10）

串口报错贴进 analyze_log 一样能分析——编译报错、烧录失败日志直接粘进来就行。

预验证驱动库（9 款）

dht11（温湿度）· hcsr04（超声波）· ds18b20（单总线温度，CRC8+补码换算）· mpu6050（六轴，量程换算+静止自检）· esp8266at（AT 响应解析库，IPD 帧+错误码）· ssd1306（OLED，帧缓冲+页寻址）· servo_sg90（舵机，角度→脉宽→定时器 CCR）· stepper_28byj48（步进电机，精确减速比 63.684:1）· hc05（蓝牙 AT 助手，响应分类+命令生成）

每个驱动：纯函数与总线时序分离（PC 可测）· wiring.md（接线表+头号坑清单按翻车率排序+答辩加分点）· meta.json 如实标注验证状态。

会话持久化（"记得住"）

serial_open 自动在 logs/ 落盘会话日志（端口/波特率/时间戳元信息 + 全部收发内容），读写时实时追加。调试被中断、换会话、隔几天之后：sessions_list 列出历史会话 → sessions_get 回看现场 → 整段喂 analyze_log。只读文件系统下静默降级，不影响主流程。

安装

# 方式一：PyPI / pip（发布形态，src 正规包——不污染 site-packages 顶层）

pip install mcu-debug-mcp # 核心（MCP 框架） pip install "mcu-debug-mcp[all]" # + pyserial（串口）+ pyocd（调试器/RTT）

方式二：从源码目录安装

pip install .[all]

方式三：开发模式（改代码即时生效；测试/审计直接从 src/ 导入）

pip install -e .[all]

装完后用 console script 起服务（等价于 python -m mcu_debug_mcp.server）

mcu-debug-mcp

客户端配置

一键安装（Claude Code / Claude Desktop / Cursor）

# Claude Code

pip install "mcu-debug-mcp[all]" claude mcp add mcu-debug-mcp -- python -m mcu_debug_mcp.server

Claude Desktop（claude_desktop_config.json）/ Cursor（mcp.json）：

"mcpServers": { "mcu-debug-mcp": { "command": "python", "args": ["-m", "mcu_debug_mcp.server"], "env": { "MCU_DEBUG_MCP_MODE": "readonly" } } } }

默认 readonly 档：读/枚举可用，写串口、烧录等硬件操作被拒并说明如何放开。

调试需要真机写入时再加 "MCU_DEBUG_MCP_MODE": "write" + MCU_DEBUG_MCP_PORT_DENY 锁住在用的口（见上文安全表）。

WorkBuddy（三步上手）

第 1 步：装包（本机需有 Python 3.10+；没有就让 WorkBuddy 代装，见下方提示词）

pip install "mcu-debug-

只显示了开头部分；其余内容请在仓库中阅读

mcu-debug-mcp

概览

PopNx MCP 的三大支柱

它能帮你做什么

安装

安装之前

需要你填写的值

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

与“其他”中的其他服务器比较i

常见问题

替代选择

Spec Driven Development

Remote Desktop Commander

Date Math

作者的 README

mcu-debug-mcp · 嵌入式调试 MCP（领域级）

安全与隔离：默认不碰硬件

与同类工具的差异（2026-09 竞品调研结论）

工具清单（59 个）

MCP resources（16 个：8 静态 + 8 模板）

pin_check 三引擎

analyze_log 覆盖的模式（45 条）

预验证驱动库（9 款）

会话持久化（"记得住"）

安装

方式二：从源码目录安装

方式三：开发模式（改代码即时生效；测试/审计直接从 src/ 导入）

装完后用 console script 起服务（等价于 python -m mcu_debug_mcp.server）

客户端配置

一键安装（Claude Code / Claude Desktop / Cursor）

WorkBuddy（三步上手）