Embedded Debugger MCP

🚀 嵌入式调试器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种工具）

💾 内存操作（2种工具）

🎯 调试控制（4种工具）

🛑 断点管理（2种工具）

📱 闪存操作（3种工具）

📡 RTT通信（6种工具）

📊 会话管理（2种工具）

✅ 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！