git clone https://github.com/你的帳號/MCP_JLINK.git
cd MCP_JLINK
pip install -e .

python -m mcp_jlink

{
  "mcpServers": {
    "jlink": {
      "command": "python",
      "args": ["-m", "mcp_jlink"],
      "cwd": "/path/to/MCP_JLINK"
    }
  }
}

你：我的板子卡住了，幫我看一下停在哪裡
AI：（自動執行 jlink_open → jlink_connect → jlink_halt → 讀取 PC/LR 暫存器 → 分析）
    程式停在 0x0800_1A3C，位於 SysTick_Handler 中。
    LR = 0xFFFF_FFF9，表示從 Thread Mode 進入中斷。
    看起來是 SysTick 中斷處理函式內的無限迴圈...

你：幫我燒錄 firmware.hex 到 STM32F407VG
AI：（自動執行 jlink_open → jlink_connect("STM32F407VG") → jlink_flash_file → jlink_reset）
    韌體燒錄完成！已寫入 32,768 bytes，耗時 1.2 秒。目標已重置並開始執行。

你：開啟 RTT 日誌，讓我看看板子在印什麼
AI：（自動執行 rtt_start → rtt_read → 持續讀取）
    RTT Channel 0 輸出：
    [INFO] System boot OK
    [INFO] Sensor init: BME280 detected
    [WARN] WiFi connection timeout, retrying...

src/mcp_jlink/
├── server.py        # FastMCP 伺服器 + 21 個 MCP tool 定義
├── connection.py    # JLinkManager 連線狀態機（單例）
├── errors.py        # 自訂例外 + 前置條件裝飾器
├── __main__.py      # python -m mcp_jlink 進入點
└── __init__.py

skills/               # AI 除錯情境指南（按需載入）
├── SKILL.md          # 主索引 + 情境路由表
├── crash-analysis.md
├── hardfault-diagnosis.md
├── peripheral-verification.md
├── flash-and-verify.md
├── rtt-logging.md
├── memory-leak-detection.md
├── variable-monitoring.md
├── interrupt-analysis.md
├── low-power-debug.md
└── batch-flashing.md

DISCONNECTED ──open()──> PROBE_OPEN ──connect()──> TARGET_CONNECTED ──rtt_start()──> RTT_ACTIVE
     ^                      |                           |                              |
     └──────close()─────────┴──────────close()──────────┴──────────close()─────────────┘

# 安裝開發相依
pip install -e ".[dev]"

# 執行測試
pytest