Embedded Debugger MCP

🚀 Embedded Debugger MCP Server

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

🚀 Quick Start

Prerequisites

Hardware Requirements:

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

Software Requirements:

• Rust 1.70+
• Drivers for debug probes compatible with probe-rs

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 the 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"
      }
    }
  }
}

For other tools like Cursor and Claude Code, please refer to the corresponding tool documentation.

✨ Features

• 🚀 Production Ready: Real hardware integration with 22 comprehensive debugging tools.
• 🔌 Multi-Probe Support: Supports J-Link, ST-Link V2/V3, DAPLink, and Black Magic Probe.
• 🎯 Complete Debug Control: Allows connection, halting, running, resetting, and single-step execution.
• 💾 Memory Operations: Enables reading and writing of flash and RAM in multiple data formats.
• 🛑 Breakpoint Management: Provides real-time control over hardware and software breakpoints.
• 📱 Flash Programming: Supports complete flash operations, including erasing, programming, and verification.
• 📡 RTT Bidirectional: Features real-time transfer with an interactive command/response system.
• 🏗️ Multi-Architecture: Compatible with ARM Cortex-M, RISC-V, and has been tested with STM32 integration.
• 🤖 AI Integration: Perfectly compatible with Claude and other AI assistants.
• 🧪 Comprehensive Testing: All 22 tools have been validated using real STM32G431CBTx hardware.

🏗️ Architecture

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

💻 Usage Examples

Basic Usage

Interact with the MCP server through AI assistants with commands like these:

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.

Advanced Usage

Try the STM32 Demo

We offer a comprehensive STM32 RTT Bidirectional Demo that demonstrates 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 receive real-time responses.
• ✅ All 22 MCP Tools: Fully validated using real STM32 hardware.
• ✅ Fibonacci Calculator: Features live data streaming with control commands.
• ✅ Hardware Integration: Tested with STM32G431CBTx + ST-Link V2.

📖 View STM32 Demo Documentation →

🛠️ Complete Tool Set (22 Tools)

All tools have been tested and validated using real STM32 hardware:

🔌 Probe Management (3 tools)

💾 Memory Operations (2 tools)

🎯 Debug Control (4 tools)

🛑 Breakpoint Management (2 tools)

📱 Flash Operations (3 tools)

📡 RTT Communication (6 tools)

📊 Session Management (2 tools)

✅ 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: Enables real hardware debugging with all 22 tools.
• ✅ Hardware Validation: Tested with STM32G431CBTx + ST-Link V2.
• ✅ RTT Bidirectional: Supports full interactive communication with real-time commands.
• ✅ Flash Operations: Provides a complete erase, program, and verify workflow.
• ✅ Session Management: Supports multiple sessions with robust error handling.
• ✅ AI Integration: Perfectly compatible with the MCP protocol.

🙏 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!