Communitygithub.com

Adancurusul/serial-mcp-server

シリアル/UARTデバイス用のRust製MCPサーバーおよびCLIツール。JSONマクロ自動化とエージェントスキルを備え、反復可能なタイミング制御ワークフローを実現します。

serial-mcp-server とは?

このスキルは、シリアル/UARTデバイスを操作するためのRustベースのMCPサーバーとCLIツール「serial-mcp-server」の使用方法を定義します。開発者やAIエージェントは、このスキルを通じてポート一覧取得、デバイスプローブ、データ書き込み/読み取り、制御ライン(RTS/DTR)の設定、そしてJSONマクロファイルを使った反復可能なシリアル手順の自動実行が可能です。対応プラットフォームはCLIおよびMCPクライアント(例:Claude Code、Cursor、Codex)で、ユーザーが明示的にMCPを要求しない限り、CLIモードを優先します。マクロ機能はv0.3時点で`send`、`delay`、`expect contains`、`expect equals`そしてアセンブリをサポートしますが、シェルコマンドやループ、変数、Quickコマンド、RTS/DTRマクロステップは未対応です。ハードウェア操作を行う前に`references/hardware-safety.md`を参照し、コマンド失敗時は`references/troubleshooting.md`を参照するよう指示されています。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add Adancurusul/serial-mcp-server

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

シリアルデバッグ

運用ルール

ユーザーが明示的に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、およびマクロを呼び出すアセンブリをサポートしています。シェルコマンド、言語実行、ループ、変数、Quickコマンド、またはRTS/DTRのマクロステップはサポートしていません。

リファレンス

  • 正確なコマンド動作、出力の期待値、自動化ルールについてはreferences/cli.mdを参照してください。
  • ユーザーがMCPのセットアップまたはMCPツールの使用を要求した場合はreferences/mcp.mdを参照してください。
  • ボーレート、配線、電圧レベル、RTS、DTR、リセット/ブートラインを変更する前にreferences/hardware-safety.mdを参照してください。
  • コマンドが失敗した、タイムアウトした、ポートが返ってこない、またはデバイスを開けない場合はreferences/troubleshooting.mdを参照してください。

レポート

コマンド、終了ステータス、関連するJSONまたはエラー抜粋を報告してください。ハードウェアが接続されていない場合は、検証サマリーをディスカバリとヘルプパスに限定してください。

関連スキル