serial-mcp-server はAIワークフローに対して2つの形式でシリアルポートアクセスを提供します:

• MCPツールをサポートするクライアント向けのMCPスタンディオサーバー。
• MCP設定なしで直接使用、CI、エージェントスキルのためのスクリプト可能なCLI。

現在のリリースターゲット:0.3.0。

言語版:英語 |中国語

0.3.0 アップデート概要

• 繰り返し可能なシリアル手続きのためのJSONマクロDSL自動化を追加。
• CLIマクロコマンドを追加:macro validate、macro list、macro plan、macro run。
• ランタイムのメモリパックでのロード/リスト/アンロード、計画、実行のためのMCPマクロツールを追加。
• マクロ検証、計画、エグゼキュータースモークテストのための明示的な非ハードウェアシミュレーションを追加。
• Quickを公開APIから除外しました。Quickスタイルのユースケースはマクロとして表現されるべきです。

マクロ自動化

シリアルワークフローが単一の読み書き以上の場合はマクロを使いましょう。多くのデバイスはタイミング付きのシーケンスを必要とします:コマンドを送信し、数ミリ秒待機し、プロンプトや確認応答が表示されるまで読み、次のコマンドを送信します。マクロパックはその手続きをJSONとして記録し、人間やCLIスクリプト、AIエージェントが検証し、計画を検査し、ハードウェアなしでシミュレーションし、デバイスが接続された実際のポートと比べて実行します。

Serial MCP Server

serial-mcp-server provides serial port access for AI workflows in two forms:

• MCP stdio server for clients that support MCP tools.
• Scriptable CLI for direct use, CI, and agent skills without MCP setup.

Current release target: 0.3.0.

Language versions: English | Chinese

0.3.0 Update Brief

• Added JSON Macro DSL automation for repeatable serial procedures.
• Added CLI macro commands: macro validate, macro list, macro plan, and macro run.
• Added MCP macro tools for runtime in-memory pack load/list/unload, plan, and run.
• Added explicit no-hardware simulation for macro validation, planning, and executor smoke tests.
• Kept Quick out of the public API. Quick-style use cases should be represented as macros.

Macro Automation

Use macros when a serial workflow is more than a single read or write. Many devices require a timed sequence: send a command, wait a few milliseconds, read until a prompt or acknowledgement appears, then send the next command. A macro pack records that procedure as JSON so a human, CLI script, or AI agent can validate it, inspect the plan, simulate it without hardware, and run it against a real port when a device is attached.

Typical macro use cases:

• Boot or provisioning flows that need ordered commands and delays.
• Protocol handshakes that must wait for OK, READY, PONG, prompts, or other expected responses.
• Regression smoke tests where the same serial procedure should run repeatedly.
• AI-assisted debugging where the agent should review the full send/delay/expect plan before touching hardware.

The v0.3 DSL is intentionally small:

• send: write UTF-8, hex, or base64 bytes.
• delay: wait for a fixed number of milliseconds.
• expect: read until the response contains or equals expected bytes.
• assembly: compose named macros into a longer workflow.

AI agents can discover macro support from this README, from the bundled skills/serial-debug skill, by running serial-mcp-server macro --help, or through MCP tool discovery when the server is configured. Agents that do not use MCP can still use the CLI plus the skill docs.

Requirements

• Rust 1.74 or newer.
• A serial device or USB-to-serial adapter when running hardware operations.
• Device drivers and OS permissions for the selected serial port.

Install From Source

git clone https://github.com/adancurusul/serial-mcp-server.git
cd serial-mcp-server
cargo build --release

The binary is built at:

target/release/serial-mcp-server

To install the CLI onto your PATH from a checkout:

cargo install --path . --locked

CLI Usage