我有一些小工具只提供 Windows 應用程式(例如一體式水冷 LCD、RGB 控制器、滑鼠),所以我開發了 usb-rea 來處理這些裝置逆向工程中枯燥的部分。使用者可以透過在供應商應用程式中點擊設定時捕捉 USB 流量(Linux 上使用 usbmon,Windows 上使用 USBPcap),標記點擊的動作,然後 usb-rea 會推斷出命令結構,包括常數位元組、計數器、線性值、查詢表以及 CRC16 等校驗碼。
它會生成一份 Markdown 報告,其中每個推斷都連結到 Wireshark 的幀號,並附帶一個獨立的 pyusb 驅動程式。由於它作為一個 MCP 伺服器運行,在 Cursor 中,AI 代理可以驅動整個流程,包含啟動捕捉、標記動作、差異比對、生成報告以及建立驅動程式骨架。為了安全起見,replay_packet 功能除非經過使用者確認,否則不會向裝置發送任何資料。
在 Cursor 中設定(路徑為 ~/.cursor/mcp.json),使用 uv 無需額外安裝:{"mcpServers": {"usb-rea": {"command": "uvx", "args": ["--from", "usb-rea", "usb-rea", "mcp"]}}}。
即使沒有實際硬體,你也可以嘗試使用它:先執行 pip install usb-rea,然後執行 usb-rea demo --device fan,它會建立一個模擬捕捉並還原協定。在實際協定上,它能精確重現 NZXT Kraken X 風扇的命令和 SteelSeries Rival 100 的表格,與 liquidctl 和 rivalcfg 的結果完全一致(已在 CI 中驗證)。
此專案目前處於 Alpha 階段,並採用 MIT 授權:GitHub - emirmrkaljevic/usb-rea。如果你有任何僅限 Windows 的 USB 裝置,我很樂意協助你進行捕捉並透過此工具分析。