Communitygithub.com

Adancurusul/serial-mcp-server

用於序列埠/UART 裝置的 Rust MCP 伺服器與命令列工具,內建 JSON 巨集自動化及代理技能,支援可重複的計時工作流程。

serial-mcp-server 是什麼?

此技能提供一個完整的 Rust 實作序列埠 MCP 伺服器與 CLI(serial-mcp-server),專為開發者與 AI 代理(如 Claude Code、Cursor 等)設計,以便與 UART/序列硬體進行互動。它能列出可用埠、執行基本煙霧測試、寫入/讀取資料、控制 RTS/DTR 訊號線,最重要的是支援 JSON 巨集套件自動化,讓重複的序列程式可以離線驗證、規劃後再實際執行。目前支援 send、delay、expect contains、expect equals 及巨集組合,但尚不支援 shell 指令、變數、迴圈或 RTS/DTR 巨集步驟。可於任何支援 Rust 二進位檔的環境中運作,並能與 MCP 客戶端整合,以便在 AI 工作流程中呼叫。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add Adancurusul/serial-mcp-server

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

序列除錯

操作規則

除非使用者明確要求 MCP 或已設定 MCP 客戶端,否則優先使用 serial-mcp-server CLI。stdout 資料與診斷資訊應分開處理,引用確切指令,且硬體操作成敗需以裝置回傳的真實指令證據為依據。

工作流程

  1. 確認二進位檔可用:
serial-mcp-server --help
  1. 在選擇裝置前列出現有埠:
serial-mcp-server list-ports --json
  1. 進行裝置煙霧測試時,先探測埠,僅在探測成功後才進行寫入/讀取:
serial-mcp-server probe --port <port> --baud 115200 --json
serial-mcp-server write --port <port> --baud 115200 --data H --read --timeout-ms 1000 --json
  1. 若涉及 RTS 或 DTR,需說明要求的線路準位,並使用控制線指令:
serial-mcp-server set-control-lines --port <port> --rts high --dtr low --json
  1. 對於可重複的序列程序,建議使用 JSON 巨集套件,並在實際硬體執行前進行驗證或規劃:
serial-mcp-server macro validate --file <pack.json> --json
serial-mcp-server macro plan --file <pack.json> --macro <name> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --simulate-read <response> --json
serial-mcp-server macro run --file <pack.json> --macro <name> --port <port> --baud 115200 --json

巨集套件是受限制的 JSON DSL 檔案。v0.3 支援 send、delay、expect contains、expect equals 以及呼叫巨集的組合。不支援 shell 指令、語言執行、迴圈、變數、快速指令或 RTS/DTR 巨集步驟。

參考資料

  • 讀取 references/cli.md 以了解精確的指令行為、輸出預期及自動化規則。
  • 當使用者要求 MCP 設定或 MCP 工具使用時,請讀取 references/mcp.md。
  • 在變更 baud、接線、電壓準位、RTS、DTR 或重置/開機線之前,請讀取 references/hardware-safety.md。
  • 當指令失敗、逾時、未回傳任何埠或無法開啟裝置時,請讀取 references/troubleshooting.md。

回報

回報指令、退出狀態及相關的 JSON 或錯誤片段。若無連接硬體,則將驗證摘要限於探索與說明路徑。

相關技能