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

필요한 것

PyPIPython의 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는 인터넷에 있는 서버에만 연결할 수 있어요. 다른 앱을 고르세요.

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

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

이 카테고리의 다른 서버 32706개 중 0%보다 스타가 많아요
이 카테고리의 다른 서버 32706개 중 72%보다 최근에 레지스트리에 공개됐어요
기본 점검 결과가 이 카테고리의 다른 서버 32706개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

자주 묻는 질문

mcu-debug-mcp, 안전한가요?

해당하는 기본 점검 1개 중 1개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.

어떤 키나 코드가 필요한가요?

레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.

내 컴퓨터에서 실행되나요, 클라우드에서 실행되나요?

내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).

아직 관리되고 있나요?

GitHub 저장소는 마지막으로 – 변경됐고, 최신 버전(0.1.1)은 15일 전 레지스트리에 올라왔어요.

어떤 앱에서 쓸 수 있나요?

Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Python (uv)도 있어야 해요.

대신 쓸 수 있는 건 뭐가 있나요?

같은 카테고리에는: Spec Driven Development, Remote Desktop Commander, Kanal Varna — drains, leaks & plumbing (Varna, BG)

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ 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그저께 업데이트

설치

Kanal Varna — drains, leaks & plumbing (Varna, BG)

제작자: kanalvarna.com

Drain unblocking, leak detection & plumbing in Varna, Bulgaria: services, prices, areas, contact

클라우드에서 실행오늘 업데이트

설치

제작자의 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

Kanal Varna — drains, leaks & plumbing (Varna, BG)

제작자의 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（三步上手）