Adancurusul/embedded-debugger-mcp

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: |

✨ 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

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)

💾 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: 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 file for details.

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