mcu-debug-mcp

Name: mcu-debug-mcp
Author: stillsurge

von stillsurgeVersion 0.1.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.stillsurge/mcu-debug-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: MCU_DEBUG_MCP_MODE, MCU_DEBUG_MCP_PORT_DENY

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

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

Führe das in deinem Terminal aus

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

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

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

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "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"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

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

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto stillsurge bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32688 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 72 % der anderen 32688 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32688 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist mcu-debug-mcp sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.1) kam vor 15 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, 御府和田玉在售作品查询

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

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

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

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

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

御府和田玉在售作品查询

von 163yu.com

Live in-stock Hetian jade from Yufu, Shanghai: prices, monthly price guide, book a viewing.

Läuft in der CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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-

Nur der Anfang wird gezeigt; den Rest findest du im Repo

mcu-debug-mcp

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

御府和田玉 在售作品查询

README vom Entwickler

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（三步上手）

御府和田玉在售作品查询