Serial Mcp Server
Expose USB serial ports to your agent so firmware logs, AT commands, and REPL consoles become structured MCP send/read operations.
Overview
io.github.es617/serial-mcp-server is a MCP server for the Build phase that lets AI agents list serial ports, connect, send commands, and read device output.
What is this MCP server?
- List serial ports, open connections, send data, and read responses via MCP tools
- SERIAL_MCP_MAX_CONNECTIONS caps simultaneous sessions (default 10)
- Optional PTY mirror on macOS/Linux: off, read-only ro, or read-write rw with SERIAL_MCP_MIRROR_LINK paths
- Plugin policy SERIAL_MCP_PLUGINS mirrors other es617 hardware servers
- PyPI serial-mcp-server 0.1.3 over stdio with configurable SERIAL_MCP_TOOL_SEPARATOR
- Package version 0.1.3 on PyPI identifier serial-mcp-server
- Default SERIAL_MCP_MAX_CONNECTIONS of 10 simultaneous connections
- PTY mirror modes documented: off, ro, and rw with default link base /tmp/serial-mcp
What problem does it solve?
Bring-up depends on serial logs and AT-style dialogs that agents cannot access when only your terminal emulator holds the session.
Who is it for?
Hardware-adjacent solo devs debugging MCUs, radios, and lab instruments over USB serial from an MCP-enabled IDE.
Skip if: Cloud-only API projects with no local serial devices, or environments where opening multiple COM ports is blocked by policy.
What do I get? / Deliverables
With the server registered, the agent can maintain serial sessions within your connection cap and optional PTY mirror for shared debugging.
- Agent-managed serial connect/send/read sessions
- Bounded concurrent connections up to configured max
- Optional mirrored PTY paths for human parallel debugging
Recommended MCP Servers
Journey fit
Serial consoles are part of building and integrating embedded services, modems, and lab hardware into the product you ship. Listing ports, opening sessions, and mirroring PTY traffic is classic device integration work for agent-assisted development.
How it compares
Serial-port MCP bridge, not a network SSH session manager or a logic analyzer SaaS.
Common Questions / FAQ
Who is io.github.es617/serial-mcp-server for?
It is for builders who debug firmware and embedded modules over serial and want agent-driven port listing, connect, send, and read flows.
When should I use io.github.es617/serial-mcp-server?
Use it during integration when you need repeatable UART interaction, log capture, or mirrored PTY access alongside your agent on macOS or Linux.
How do I add io.github.es617/serial-mcp-server to my agent?
Install serial-mcp-server 0.1.3 from PyPI, configure stdio in your MCP host, tune SERIAL_MCP_MAX_CONNECTIONS and mirror settings if needed, then grant USB serial permissions on your OS.