serial-mcp-server обеспечивает доступ к последовательным портам для рабочих процессов ИИ в двух формах:

• MCP stdio server для клиентов, поддерживающих инструменты MCP.
• Скриптируемый CLI для прямого использования, CI и навыков агента без настройки MCP.

Текущая цель выпуска: 0.3.0.

Языковые версии: английский | Китайский

Краткий обзор обновления 0.3.0

• Добавлена автоматизация JSON Macro 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