Embedded Debugger MCP Server

A professional Model Context Protocol (MCP) server for embedded debugging with probe-rs. Provides AI assistants with comprehensive debugging capabilities for embedded systems including ARM Cortex-M, RISC-V microcontrollers with real hardware integration.

📖 Language Versions: English | 中文

✨ Features

• 🚀 Production Ready: Real hardware integration with 22 comprehensive debugging tools
• 🔌 Multi-Probe Support: J-Link, ST-Link V2/V3, DAPLink, Black Magic Probe
• 🎯 Complete Debug Control: Connect, halt, run, reset, single-step execution
• 💾 Memory Operations: Read/write flash and RAM with multiple data formats
• 🛑 Breakpoint Management: Hardware and software breakpoints with real-time control
• 📱 Flash Programming: Complete flash operations - erase, program, verify
• 📡 RTT Bidirectional: Real-Time Transfer with interactive command/response system
• 🏗️ Multi-Architecture: ARM Cortex-M, RISC-V with tested STM32 integration
• 🤖 AI Integration: Perfect compatibility with Claude and other AI assistants
• 🧪 Comprehensive Testing: All 22 tools validated with real STM32G431CBTx hardware

🏗️ Architecture

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP Client    │◄──►│  Embedded        │◄──►│  Debug Probe    │
│   (Claude/AI)   │    │  Debugger MCP    │    │  Hardware       │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  Target Device   │
                       │  (ARM/RISC-V)    │
                       └──────────────────┘

🚀 Quick Start

Prerequisites

Hardware Requirements:

• Debug Probe: ST-Link V2/V3, J-Link, or DAPLink compatible probe
• Target Board: STM32 or other supported microcontroller
• Connection: USB cables for probe and target board

Software Requirements:

• Rust 1.70+
• probe-rs compatible debug probe drivers

Installation

# Clone and build from source
git clone https://github.com/adancurusul/embedded-debugger-mcp.git
cd embedded-debugger-mcp
cargo build --release

Basic Usage

Configure MCP Clients

Claude Desktop Configuration Example

Add to Claude Desktop configuration file:

Windows Example:

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

macOS/Linux Example:

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

Other examples for other tools like cursor ,claude code etc. please refer to the corresponding tool documentation

🎯 Try the STM32 Demo

We provide a comprehensive STM32 RTT Bidirectional Demo that showcases all capabilities:

# Navigate to the example
cd examples/STM32_demo

# Build the firmware  
cargo build --release

# Use with MCP server for complete debugging experience

What the demo shows:

• ✅ Interactive RTT Communication: Send commands and get real-time responses
• ✅ All 22 MCP Tools: Complete validation with real STM32 hardware
• ✅ Fibonacci Calculator: Live data streaming with control commands
• ✅ Hardware Integration: Tested with STM32G431CBTx + ST-Link V2

📖 View STM32 Demo Documentation →

Usage Examples with AI Assistants

List Available Debug Probes

Please list available debug probes on the system

Connect and Flash Firmware

Connect to my STM32G431CBTx using ST-Link probe, then flash the firmware at examples/STM32_demo/target/thumbv7em-none-eabi/release/STM32_demo

Interactive RTT Communication

Please attach RTT and show me the data from the terminal channel. Then send a command 'L' to toggle the LED.

Memory Analysis

Read 64 bytes of memory from address 0x08000000 and analyze the data format

Test All 22 MCP Tools

Please help me test all 22 MCP embedded debugger tools with my STM32 board. Start by connecting to the probe, then systematically test each tool category: probe management, memory operations, debug control, breakpoints, flash operations, RTT communication, and session management.

🛠️ Complete Tool Set (22 Tools)

All tools tested and validated with real STM32 hardware:

🔌 Probe Management (3 tools)

Tool	Description	Status
list_probes	Discover available debug probes	✅ Production Ready
connect	Connect to probe and target chip	✅ Production Ready
probe_info	Get detailed session information	✅ Production Ready

💾 Memory Operations (2 tools)

Tool	Description	Status
read_memory	Read flash/RAM with multiple formats	✅ Production Ready
write_memory	Write to target memory	✅ Production Ready

🎯 Debug Control (4 tools)

Tool	Description	Status
halt	Stop target execution	✅ Production Ready
run	Resume target execution	✅ Production Ready
reset	Hardware/software reset	✅ Production Ready
step	Single instruction stepping	✅ Production Ready

🛑 Breakpoint Management (2 tools)

Tool	Description	Status
set_breakpoint	Set hardware/software breakpoints	✅ Production Ready
clear_breakpoint	Remove breakpoints	✅ Production Ready

📱 Flash Operations (3 tools)

Tool	Description	Status
flash_erase	Erase flash memory sectors/chip	✅ Production Ready
flash_program	Program ELF/HEX/BIN files	✅ Production Ready
flash_verify	Verify flash contents	✅ Production Ready

📡 RTT Communication (6 tools)

Tool	Description	Status
rtt_attach	Connect to RTT communication	✅ Production Ready
rtt_detach	Disconnect RTT	✅ Production Ready
rtt_channels	List available RTT channels	✅ Production Ready
rtt_read	Read from RTT up channels	✅ Production Ready
rtt_write	Write to RTT down channels	✅ Production Ready
run_firmware	Complete deployment + RTT	✅ Production Ready

📊 Session Management (2 tools)

Tool	Description	Status
get_status	Get current debug status	✅ Production Ready
disconnect	Clean session termination	✅ Production Ready

✅ 22/22 Tools - 100% Success Rate with Real Hardware

🌍 Supported Hardware

Debug Probes

• J-Link: Segger J-Link (all variants)
• ST-Link: ST-Link/V2, ST-Link/V3
• DAPLink: ARM DAPLink compatible probes
• Black Magic Probe: Black Magic Probe
• FTDI: FTDI-based debug probes

Target Architectures

• ARM Cortex-M: M0, M0+, M3, M4, M7, M23, M33
• RISC-V: Various RISC-V cores
• ARM Cortex-A: Basic support

🏆 Production Status

✅ Fully Implemented and Tested

Current Status: PRODUCTION READY

• ✅ Complete probe-rs Integration: Real hardware debugging with all 22 tools
• ✅ Hardware Validation: Tested with STM32G431CBTx + ST-Link V2
• ✅ RTT Bidirectional: Full interactive communication with real-time commands
• ✅ Flash Operations: Complete erase, program, verify workflow
• ✅ Session Management: Multi-session support with robust error handling
• ✅ AI Integration: Perfect MCP protocol compatibility

🙏 Acknowledgments

Thanks to the following open source projects:

• probe-rs - Embedded debugging toolkit
• rmcp - Rust MCP SDK
• tokio - Async runtime

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

⭐ If this project helps you, please give us a Star!