How to add Embedded Debugger MCP Server to Windsurf

Debug embedded systems (ARM Cortex-M, RISC-V) from AI assistants via probe-rs. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 113★ · stdio · no auth

Windsurf config for Embedded Debugger MCP Server

git clone https://github.com/adancurusul/embedded-debugger-mcp.git && cd embedded-debugger-mcp && cargo build --release

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

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Embedded Debugger MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Embedded Debugger MCP Server's tools become available to Cascade.

Before you start

Rust 1.70+ to build from source
A probe-rs compatible debug probe (ST-Link V2/V3, J-Link, or DAPLink) with drivers installed
A supported target board (e.g. STM32 microcontroller)
USB connection to the probe and target board

What Embedded Debugger MCP Server can do in Windsurf

list_probes

Discover available debug probes on the system.

connect

Connect to a probe and target chip.

probe_info

Get detailed session information.

read_memory

Read flash/RAM with multiple data formats.

write_memory

Write to target memory.

halt

Stop target execution.

run

Resume target execution.

reset

Perform a hardware or software reset.

Security

Runs as a local stdio process and controls real debug hardware (flash erase/program, memory write, target reset). Only connect it to probes and target boards you intend to expose to the AI assistant.

Embedded Debugger MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Embedded Debugger MCP Server config there under the "mcpServers" key and restart the client.

Is Embedded Debugger MCP Server safe to use with Windsurf?

Runs as a local stdio process and controls real debug hardware (flash erase/program, memory write, target reset). Only connect it to probes and target boards you intend to expose to the AI assistant.

Which debug probes are supported?

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

Which target architectures work?

ARM Cortex-M (M0, M0+, M3, M4, M7, M23, M33) and various RISC-V cores, with basic support for ARM Cortex-A.

Is there a prebuilt package?

No. The README documents building from source with cargo build --release; there is no npm or other registry package listed.

View repo Full Embedded Debugger MCP Server page