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！