MCP 服务器

Embedded xLink MCP

MCP server for embedded debugging based on probe-rs, providing 22 tools for ARM Cortex-M and RISC-V microcontrollers, including connection, memory operations, breakpoints, flash programming, and RTT communication.

README

Embedded xLink MCP 服务器

专业的模型上下文协议 (MCP) 嵌入式调试服务器，基于 probe-rs 构建。为 AI 助手提供包括 ARM Cortex-M、RISC-V 微控制器在内的全面嵌入式系统调试功能，支持真实硬件集成。

📖 语言版本: English | 中文

✨ 功能特性

🚀 生产就绪: 真实硬件集成，提供22个综合调试工具
🔌 多探针支持: J-Link, ST-Link V2/V3, DAPLink, Black Magic Probe
🎯 完整调试控制: 连接、暂停、运行、复位、单步执行
💾 内存操作: 支持多种数据格式的Flash和RAM读写
🛑 断点管理: 硬件和软件断点的实时控制
📱 Flash编程: 完整的Flash操作 - 擦除、编程、验证
📡 RTT双向通信: 实时传输，支持交互式命令/响应系统
🏗️ 多架构支持: ARM Cortex-M, RISC-V，经过STM32集成测试
🤖 AI集成: 与Claude和其他AI助手完美兼容
🧪 全面测试: 所有22个工具在真实STM32G431CBTx硬件上验证通过

🏗️ 架构

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCP 客户端    │◄──►│  xLink MCP       │◄──►│  调试探针       │
│   (Claude/AI)   │    │  MCP 服务器      │    │  硬件           │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  目标设备        │
                       │  (ARM/RISC-V)    │
                       └──────────────────┘

🚀 快速开始

前置要求

硬件要求:

调试探针: ST-Link V2/V3, J-Link, 或 DAPLink 兼容探针
目标板: STM32 或其他支持的微控制器
连接线: 用于探针和目标板的USB线

软件要求:

Rust 1.70+
probe-rs 兼容的调试探针驱动程序

安装

# 克隆并从源码构建
git clone https://github.com/vividcode-ai/embedded-xLink-mcp.git
cd embedded-xLink-mcp
cargo build --release

基本使用

配置 MCP 客户端

Claude Desktop 配置示例

添加到 Claude Desktop 配置文件:

Windows 示例:

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

macOS/Linux 示例:

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

其他例如cursor ,claude code 等参考对应工具文档

🎯 试试 STM32 演示

我们提供了一个全面的 STM32 RTT 双向通信演示，展示了所有功能：

# 进入示例目录
cd examples/STM32_demo

# 构建固件
cargo build --release

# 与 MCP 服务器配合使用，获得完整的调试体验

演示内容:

✅ 交互式 RTT 通信: 发送命令并获得实时响应
✅ 全部 22 个 MCP 工具: 在真实 STM32 硬件上完整验证
✅ 斐波那契计算器: 实时数据流与控制命令
✅ 硬件集成: 在 STM32G431CBTx + ST-Link V2 上测试

📖 查看 STM32 演示文档 →

AI 助手使用示例

列出可用的调试探针

请列出系统上可用的调试探针

连接并烧录固件

使用 ST-Link 探针连接到我的 STM32G431CBTx，然后烧录位于 examples/STM32_demo/target/thumbv7em-none-eabi/release/STM32_demo 的固件

交互式 RTT 通信

请连接 RTT 并显示终端通道的数据。然后发送命令 'L' 来切换 LED。

内存分析

读取地址 0x08000000 处的 64 字节内存并分析数据格式

测试全部 22 个 MCP 工具

请帮我测试所有 22 个 MCP 嵌入式调试工具与我的 STM32 开发板。先连接到探针，然后系统性地测试每个工具类别：探针管理、内存操作、调试控制、断点、Flash 操作、RTT 通信和会话管理。

🛠️ 完整工具集 (22个工具)

所有工具均通过真实 STM32 硬件测试和验证：

🔌 探针管理 (3个工具)

工具	描述	状态
`list_probes`	发现可用的调试探针	✅ 生产就绪
`connect`	连接到探针和目标芯片	✅ 生产就绪
`probe_info`	获取详细会话信息	✅ 生产就绪

💾 内存操作 (2个工具)

工具	描述	状态
`read_memory`	支持多种格式的Flash/RAM读取	✅ 生产就绪
`write_memory`	向目标内存写入数据	✅ 生产就绪

🎯 调试控制 (4个工具)

工具	描述	状态
`halt`	停止目标执行	✅ 生产就绪
`run`	恢复目标执行	✅ 生产就绪
`reset`	硬件/软件复位	✅ 生产就绪
`step`	单指令步进	✅ 生产就绪

🛑 断点管理 (2个工具)

工具	描述	状态
`set_breakpoint`	设置硬件/软件断点	✅ 生产就绪
`clear_breakpoint`	移除断点	✅ 生产就绪

📱 Flash 操作 (3个工具)

工具	描述	状态
`flash_erase`	擦除Flash内存扇区/芯片	✅ 生产就绪
`flash_program`	编程 ELF/HEX/BIN 文件	✅ 生产就绪
`flash_verify`	验证Flash内容	✅ 生产就绪

📡 RTT 通信 (6个工具)

工具	描述	状态
`rtt_attach`	连接到RTT通信	✅ 生产就绪
`rtt_detach`	断开RTT连接	✅ 生产就绪
`rtt_channels`	列出可用的RTT通道	✅ 生产就绪
`rtt_read`	从RTT上行通道读取	✅ 生产就绪
`rtt_write`	向RTT下行通道写入	✅ 生产就绪
`run_firmware`	完整部署 + RTT	✅ 生产就绪