金大哥 - embedded-debugger-mcp MCP 详情

article

README

🚀 嵌入式调试器MCP服务器

一款专业的模型上下文协议（MCP）服务器，用于结合probe-rs进行嵌入式调试。为AI助手提供针对嵌入式系统的全面调试功能，支持包括ARM Cortex - M、RISC - V微控制器在内的嵌入式系统，并可与真实硬件集成。

📖 语言版本：英文 | 中文

✨ 主要特性

🚀 生产就绪：与真实硬件集成，具备22种全面的调试工具
🔌 多探针支持：支持J - Link、ST - Link V2/V3、DAPLink、Black Magic Probe等调试探针
🎯 完整的调试控制：可进行连接、暂停、运行、复位、单步执行等操作
💾 内存操作：支持以多种数据格式读写闪存和RAM
🛑 断点管理：支持硬件和软件断点，并可进行实时控制
📱 闪存编程：可完成闪存擦除、编程、验证等操作
📡 RTT双向通信：具备实时传输功能，拥有交互式命令/响应系统
🏗️ 多架构支持：支持ARM Cortex - M、RISC - V架构，且经过STM32集成测试
🤖 AI集成：与Claude等AI助手完美兼容
🧪 全面测试：所有22种工具均在真实的STM32G431CBTx硬件上进行了验证

🏗️ 架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP客户端     │◄──►│  嵌入式调试器MCP │◄──►│  调试探针硬件    │
│   (Claude/AI)   │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  目标设备        │
                       │  (ARM/RISC - V)  │
                       └──────────────────┘

🚀 快速开始

前提条件

硬件要求：

调试探针：支持J - Link、ST - Link V2/V3、DAPLink等兼容的调试探针
目标开发板：STM32或其他支持的微控制器开发板
连接方式：使用USB线缆连接调试探针和目标开发板

软件要求：

Rust 1.70+
与probe - rs兼容的调试探针驱动程序

安装

# 从源代码克隆并构建
git clone https://github.com/adancurusul/embedded-debugger-mcp.git
cd embedded-debugger-mcp
cargo build --release

基本用法

配置MCP客户端

Claude桌面端配置示例

添加到Claude桌面端配置文件中：

Windows示例：

{
  "mcpServers": {
    "embedded-debugger": {
      "command": "C:\\path\\to\\debugger-mcp-rs\\target\\release\\embedded-debugger-mcp.exe",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

macOS/Linux示例：

{
  "mcpServers": {
    "embedded-debugger": {
      "command": "/path/to/debugger-mcp-rs/target/release/embedded-debugger-mcp",
      "args": [],
      "env": {
        "RUST_LOG": "info"
      }
    }
  }
}

其他工具（如cursor、Claude Code等）的示例，请参考相应工具的文档。

🎯 尝试STM32演示

我们提供了一个全面的STM32 RTT双向演示，展示了所有功能：

# 进入示例目录
cd examples/STM32_demo

# 构建固件
cargo build --release

# 结合MCP服务器进行完整的调试体验

演示展示内容：

✅ 交互式RTT通信：发送命令并获取实时响应
✅ 所有22种MCP工具：在真实的STM32硬件上进行了完整验证
✅ 斐波那契计算器：通过控制命令实现实时数据流传输
✅ 硬件集成：在STM32G431CBTx + ST - Link V2上进行了测试

📖 查看STM32演示文档 →

与AI助手的使用示例

列出可用的调试探针

请列出系统上可用的调试探针

连接并烧录固件

使用ST - Link探针连接到我的STM32G431CBTx，然后烧录位于examples/STM32_demo/target/thumbv7em-none-eabi/release/STM32_demo的固件

交互式RTT通信

请连接RTT并显示终端通道的数据。然后发送命令 'L' 来切换LED状态。

内存分析

从地址0x08000000读取64字节的内存并分析数据格式

测试所有22种MCP工具

请帮助我使用我的STM32开发板测试所有22种MCP嵌入式调试工具。首先连接到探针，然后系统地测试每个工具类别：探针管理、内存操作、调试控制、断点、闪存操作、RTT通信和会话管理。

🛠️ 完整工具集（22种工具）

所有工具均在真实的STM32硬件上进行了测试和验证：

🔌 探针管理（3种工具）

| 工具 | 描述 | 状态 | |------|------|------| | list_probes | 发现可用的调试探针 | ✅ 生产就绪 | | connect | 连接到探针和目标芯片 | ✅ 生产就绪 | | probe_info | 获取详细的会话信息 | ✅ 生产就绪 |

💾 内存操作（2种工具）

| 工具 | 描述 | 状态 | |------|------|------| | read_memory | 以多种格式读取闪存/RAM | ✅ 生产就绪 | | write_memory | 写入目标内存 | ✅ 生产就绪 |

🎯 调试控制（4种工具）

| 工具 | 描述 | 状态 | |------|------|------| | halt | 停止目标执行 | ✅ 生产就绪 | | run | 恢复目标执行 | ✅ 生产就绪 | | reset | 硬件/软件复位 | ✅ 生产就绪 | | step | 单指令步进 | ✅ 生产就绪 |

🛑 断点管理（2种工具）

| 工具 | 描述 | 状态 | |------|------|------| | set_breakpoint | 设置硬件/软件断点 | ✅ 生产就绪 | | clear_breakpoint | 清除断点 | ✅ 生产就绪 |

📱 闪存操作（3种工具）

| 工具 | 描述 | 状态 | |------|------|------| | flash_erase | 擦除闪存扇区/芯片 | ✅ 生产就绪 | | flash_program | 烧录ELF/HEX/BIN文件 | ✅ 生产就绪 | | flash_verify | 验证闪存内容 | ✅ 生产就绪 |

📡 RTT通信（6种工具）

| 工具 | 描述 | 状态 | |------|------|------| | rtt_attach | 连接到RTT通信 | ✅ 生产就绪 | | rtt_detach | 断开RTT连接 | ✅ 生产就绪 | | rtt_channels | 列出可用的RTT通道 | ✅ 生产就绪 | | rtt_read | 从RTT上行通道读取数据 | ✅ 生产就绪 | | rtt_write | 向RTT下行通道写入数据 | ✅ 生产就绪 | | run_firmware | 完成部署 + RTT | ✅ 生产就绪 |

📊 会话管理（2种工具）

| 工具 | 描述 | 状态 | |------|------|------| | get_status | 获取当前调试状态 | ✅ 生产就绪 | | disconnect | 干净地终止会话 | ✅ 生产就绪 |

✅ 22/22工具 - 在真实硬件上成功率达100%

🌍 支持的硬件

调试探针

J - Link：Segger J - Link（所有型号）
ST - Link：ST - Link/V2、ST - Link/V3
DAPLink：与ARM DAPLink兼容的调试探针
Black Magic Probe：Black Magic Probe
FTDI：基于FTDI的调试探针

目标架构

ARM Cortex - M：M0、M0+、M3、M4、M7、M23、M33
RISC - V：各种RISC - V内核
ARM Cortex - A：基本支持

🏆 生产状态

✅ 完全实现并测试

当前状态：生产就绪

✅ 完整的probe - rs集成：使用所有22种工具进行真实硬件调试
✅ 硬件验证：在STM32G431CBTx + ST - Link V2上进行了测试
✅ RTT双向通信：支持实时命令的全交互式通信
✅ 闪存操作：完整的擦除、编程、验证工作流程
✅ 会话管理：支持多会话，具备强大的错误处理能力
✅ AI集成：与MCP协议完美兼容

🙏 致谢

感谢以下开源项目：

probe - rs - 嵌入式调试工具包
rmcp - Rust MCP SDK
tokio - 异步运行时

📄 许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

⭐ 如果本项目对您有帮助，请给我们一个Star！

embedded-debugger-mcp