serial-mcp

Give an LLM a reliable serial connection to microcontrollers, routers, modems, embedded Linux systems, and anything else with a UART.

serial-mcp is an MCP server built for real device work: interactive shells, bootloader prompts, binary protocols, logging, and file transfers. It continuously buffers incoming data so output is not lost between tool calls.

Claude using serial-mcp to inspect a connected device

Install

The PyPI package is named pyserial-mcp; the command it installs is serial-mcp.

uv tool install pyserial-mcp

Or with pip:

pip install pyserial-mcp

Python 3.10 or newer is required.

Connect it to your MCP client

For Claude Code:

claude mcp add serial-mcp -- serial-mcp

For clients that use an MCP JSON configuration:

{
  "mcpServers": {
    "serial": {
      "command": "serial-mcp"
    }
  }
}

To run without installing, use "command": "uvx" and "args": ["pyserial-mcp"] instead.

What it can do

Discover serial ports and USB metadata, then detect an unknown baud rate.
Run a single command with automatic open/close, or keep a session open for an interactive shell.
Read and write text, raw bytes, and hex data without losing output between calls.
React immediately to boot prompts with regex-triggered text or binary replies.
Control DTR, RTS, break, and read CTS, DSR, RI, and CD signals.
Capture logs and send or receive files with XMODEM checksum or CRC-16.
Identify the process holding a busy port and, with explicit use of serial_force_release, terminate it.

Open sessions automatically close after 15 minutes of inactivity by default. Clients should still call serial_close as soon as a session is finished so the port is available to other programs.

Typical workflows

Ask your LLM naturally, for example:

Find the connected serial device, detect its baud rate, and show me its shell prompt.

For one command, the server provides a safe one-shot tool:

serial_execute(port="/dev/ttyUSB0", data="uname -a", expect="\\$")

For longer work, use serial_open, one or more serial_command calls, and serial_close. Use serial_wait_for(..., respond=" ") to catch a time-sensitive prompt such as U-Boot's autoboot interruption.

Tool profiles

The default full profile exposes all 24 tools. If your client loads every tool schema and you only need common text workflows, use the smaller seven-tool profile:

serial-mcp --profile core

You can also set SERIAL_MCP_TOOL_PROFILE=core in the server environment.

Development

No hardware is required to run the test suite:

git clone https://github.com/alxgmpr/serial-mcp.git
cd serial-mcp
uv pip install -e ".[dev]"
pytest -v

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyserial_mcp-0.7.2.tar.gz (102.6 kB view details)

Uploaded Aug 26, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pyserial_mcp-0.7.2-py3-none-any.whl (24.2 kB view details)

Uploaded Aug 26, 2026 Python 3

File details

Details for the file pyserial_mcp-0.7.2.tar.gz.

File metadata

Download URL: pyserial_mcp-0.7.2.tar.gz
Upload date: Aug 26, 2026
Size: 102.6 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for pyserial_mcp-0.7.2.tar.gz
Algorithm	Hash digest
SHA256	`90ff3ce82c62836a33dd2cd3c999b1ab5dbac27ba44eb6a91d3da5ac50d32a05`
MD5	`2e7a5b795a114ce5a864275ac5719eaa`
BLAKE2b-256	`7c10bef45706fff3cab5ead9274ce65a9a35bb8feff056633cc702850db48ba5`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyserial_mcp-0.7.2.tar.gz:

Publisher: release.yml on alxgmpr/serial-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pyserial_mcp-0.7.2.tar.gz
- Subject digest: 90ff3ce82c62836a33dd2cd3c999b1ab5dbac27ba44eb6a91d3da5ac50d32a05
- Sigstore transparency entry: 2603159433
- Sigstore integration time: Aug 26, 2026
Source repository:
- Permalink: alxgmpr/serial-mcp@52afbd521ddb38983a378ec8345dd1b12b241a0b
- Branch / Tag: refs/tags/v0.7.2
- Owner: https://github.com/alxgmpr
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@52afbd521ddb38983a378ec8345dd1b12b241a0b
- Trigger Event: push