Embedded Debugger MCP

🚀 組み込みデバッガMCPサーバー

probe-rsを使用した組み込みデバッグ用の専用モデルコンテキストプロトコル（MCP）サーバーです。ARM Cortex-MやRISC-Vマイクロコントローラーを含む組み込みシステムに対し、AIアシスタントに包括的なデバッグ機能を提供し、実際のハードウェアとの統合が可能です。

📖 言語バージョン: 英語 | 中国語

✨ 主な機能

• 🚀 本番環境対応: 22の包括的なデバッグツールを備え、実際のハードウェアと統合可能
• 🔌 複数プローブ対応: J-Link、ST-Link V2/V3、DAPLink、Black Magic Probe
• 🎯 完全なデバッグ制御: 接続、停止、実行、リセット、単ステップ実行
• 💾 メモリ操作: 複数のデータ形式でフラッシュとRAMの読み書きが可能
• 🛑 ブレークポイント管理: ハードウェアとソフトウェアのブレークポイントをリアルタイムで制御
• 📱 フラッシュプログラミング: 消去、プログラミング、検証などの完全なフラッシュ操作
• 📡 RTT双方向通信: インタラクティブなコマンド/レスポンスシステムを備えたリアルタイム転送
• 🏗️ 複数アーキテクチャ対応: ARM Cortex-M、RISC-V（STM32との統合がテスト済み）
• 🤖 AI統合: ClaudeなどのAIアシスタントと完全互換
• 🧪 包括的なテスト: すべての22のツールが実際のSTM32G431CBTxハードウェアで検証済み

🏗️ アーキテクチャ

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   MCPクライアント   │◄──►│  組み込みデバッガMCP  │◄──►│  デバッグプローブハードウェア  │
│   (Claude/AI)   │    │                  │    │                 │
└─────────────────┘    └──────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌──────────────────┐
                       │  ターゲットデバイス  │
                       │  (ARM/RISC-V)    │
                       └──────────────────┘

🚀 クイックスタート

前提条件

ハードウェア要件:

• デバッグプローブ: ST-Link V2/V3、J-Link、またはDAPLink互換のプローブ
• ターゲットボード: STM32またはその他のサポートされるマイクロコントローラー
• 接続: プローブとターゲットボード用のUSBケーブル

ソフトウェア要件:

• Rust 1.70以上
• probe-rs互換のデバッグプローブドライバー

インストール

# ソースからクローンしてビルド
git clone https://github.com/adancurusul/embedded-debugger-mcp.git
cd embedded-debugger-mcp
cargo build --release

基本的な使用法

MCPクライアントの設定

Claudeデスクトップの設定例

Claudeデスクトップの設定ファイルに追加します。

Windowsの例:

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

macOS/Linuxの例:

{
  "mcpServers": {
    "embedded-debugger": {
      "command": "/path/to/debugger-mcp-rs/target/release/embedded-debugger-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ツールをテストする

STM32ボードですべての22のMCP組み込みデバッガツールをテストしてください。まずプローブに接続し、その後、プローブ管理、メモリ操作、デバッグ制御、ブレークポイント、フラッシュ操作、RTT通信、セッション管理などの各ツールカテゴリを体系的にテストしてください

🛠️ 完全なツールセット（22のツール）

すべてのツールは実際のSTM32ハードウェアでテストおよび検証されています。

🔌 プローブ管理（3つのツール）

💾 メモリ操作（2つのツール）

🎯 デバッグ制御（4つのツール）

🛑 ブレークポイント管理（2つのツール）

📱 フラッシュ操作（3つのツール）

📡 RTT通信（6つのツール）

📊 セッション管理（2つのツール）

✅ 22/22のツール - 実際のハードウェアで100%成功率

🌍 サポートされるハードウェア

デバッグプローブ

• J-Link: Segger J-Link（すべてのバリエーション）
• ST-Link: ST-Link/V2、ST-Link/V3
• DAPLink: ARM DAPLink互換のプローブ
• Black Magic Probe: Black Magic Probe
• FTDI: FTDIベースのデバッグプローブ

ターゲットアーキテクチャ

• ARM Cortex-M: M0、M0+、M3、M4、M7、M23、M33
• RISC-V: 様々なRISC-Vコア
• ARM Cortex-A: 基本的なサポート

🏆 本番環境対応状況

✅ 完全に実装され、テスト済み

現在の状態: 本番環境対応

• ✅ 完全なprobe-rs統合: すべての22のツールを使用した実際のハードウェアデバッグ
• ✅ ハードウェア検証: STM32G431CBTx + ST-Link V2でテスト済み
• ✅ RTT双方向通信: リアルタイムコマンドを使用した完全なインタラクティブ通信
• ✅ フラッシュ操作: 完全な消去、プログラミング、検証のワークフロー
• ✅ セッション管理: 堅牢なエラー処理を備えたマルチセッションサポート
• ✅ AI統合: 完全なMCPプロトコル互換性

🙏 謝辞

以下のオープンソースプロジェクトに感謝します。

• probe-rs - 組み込みデバッグツールキット
• rmcp - Rust MCP SDK
• tokio - 非同期ランタイム

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細についてはLICENSEファイルを参照してください。

⭐ このプロジェクトが役に立った場合は、スターを付けてください！