Home › Other › serial-mcp-server

serial-mcp-server

Let AI agents interact with serial devices — list ports, connect, send, and read.

Python

★ 21 stars Last pushed 2026-03-07 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (pypi 0.1.3)

uvx serial-mcp-server

Or add to your MCP client config:

{
  "mcpServers": {
    "serial-mcp-server": {
      "command": "uvx",
      "args": [
        "serial-mcp-server"
      ],
      "env": {
        "SERIAL_MCP_MAX_CONNECTIONS": "<YOUR_VALUE>",
        "SERIAL_MCP_PLUGINS": "<YOUR_VALUE>",
        "SERIAL_MCP_MIRROR": "<YOUR_VALUE>",
        "SERIAL_MCP_MIRROR_LINK": "<YOUR_VALUE>",
        "SERIAL_MCP_TOOL_SEPARATOR": "<YOUR_VALUE>"
      }
    }
  }
}

SERIAL_MCP_MAX_CONNECTIONS — Maximum simultaneous open serial connections (default 10)
SERIAL_MCP_PLUGINS — Plugin policy: 'all' or comma-separated plugin names. Unset = disabled.
SERIAL_MCP_MIRROR — PTY mirror mode: 'off' (default), 'ro' (read-only), or 'rw' (read-write). macOS/Linux only.
SERIAL_MCP_MIRROR_LINK — Base path for PTY symlinks (default /tmp/serial-mcp when mirror is enabled). Connections get numbered: /tmp/serial-mcp0, /tmp/serial-mcp1, etc.
SERIAL_MCP_TOOL_SEPARATOR — Tool name separator character (default '.'). Set to '_' for clients that reject dots (e.g. Cursor).