serial-mcp-server는 AI 워크플로우에 대해 두 가지 형태로 직렬 포트 접근을 제공합니다:

• MCP 도구를 지원하는 클라이언트용 MCP stdio 서버.
• 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