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

hljs language-scss

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   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

hljs language-bash

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

hljs language-json

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

macOS/Linux Example:

hljs language-json

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

hljs language-bash

# 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

hljs language-arduino

Please list available debug probes on the system

Connect and Flash Firmware

hljs language-sql

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

hljs language-vbnet

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

Memory Analysis

hljs language-python

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

Test All 22 MCP Tools

hljs language-vbnet

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!

embedded-debugger-mcp