UART MCP Server

Windows-only Python MVP for reading UART logs from Codex through MCP while also showing the same serial stream in a small Tkinter UI.

Features

• Enumerate available Windows COM ports.
• Open and close one serial port.
• Select common baud rates or enter a custom baud rate.
• Show recent UART logs in a Tkinter window.
• Let Codex read recent logs through MCP.
• Clear logs.
• Send text to the UART, optionally appending CRLF.

Setup

python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements-dev.txt
pip install -e .

Run UI

python -m uart_mcp_server.app --ui

UI supports:

• Resizable receive and send panes.
• Receive display as ASCII or HEX.
• Multi-line one-shot send as ASCII or space-separated HEX.
• Independent loop send area with format, interval, and repeat count.
• Loop count 0 means send forever until Stop is clicked.

HEX send format uses space-separated bytes:

01 03 00 00 00 02

Run MCP Server

python -m uart_mcp_server.app --mcp

Codex MCP Example

Add this to your Codex config.toml, adjusting the path to this repository:

[mcp_servers.uart]
command = "python"
args = ["-m", "uart_mcp_server.app", "--mcp"]
cwd = "D:\\UART MCP"
startup_timeout_sec = 10
tool_timeout_sec = 30

Notes

The MVP opens one serial port at a time. Windows usually does not allow two processes to open the same COM port simultaneously.