🔌 serial-mcp

MCP server for serial port communication. Provides tools to open, read, write, and manage serial ports through the Model Context Protocol.

🤖 Written by and for AI.

✨ Features

• 📋 List available serial ports on the system

• ⚙️ Open ports with configurable baud rate, parity, stop bits, and flow control

• 📖 Read data by byte count, terminator character, or duration

• ✍️ Write string or hex data

• 💥 Send BREAK signals

• 📊 Monitor port status and control line states

Related MCP server: embedded-serial-mcp

📦 Prerequisites

• Python 3.10+

• uv package manager

🚀 Installation

Via PyPI

uvx serial-mcp@latest

Local Clone

git clone https://github.com/davidalo/serial-mcp.git
cd serial-mcp
uvx --from "$(pwd)" serial-mcp

🔗 Integration

Via PyPI

# Claude Code
claude mcp add serial -- uvx serial-mcp@latest

# Codex CLI
codex mcp add serial -- uvx serial-mcp@latest

Local Clone

git clone https://github.com/davidalo/serial-mcp.git
cd serial-mcp

# Claude Code
claude mcp add serial -- uvx --from "$(pwd)" serial-mcp

# Codex CLI
codex mcp add serial -- uvx --from "$(pwd)" serial-mcp

🛠️ Tools

🧪 Testing with Virtual Ports

Use socat to create virtual serial port pairs for testing:

# Create virtual port pair
socat -d -d pty,raw,echo=0,link=/tmp/ttyV0 pty,raw,echo=0,link=/tmp/ttyV1

Then open /tmp/ttyV0 with the MCP server and /tmp/ttyV1 with another terminal program to test communication.

📄 License

MIT