Content
# 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
```powershell
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements-dev.txt
pip install -e .
```
## Run UI
```powershell
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:
```text
01 03 00 00 00 02
```
## Run MCP Server
```powershell
python -m uart_mcp_server.app --mcp
```
## Codex MCP Example
Add this to your Codex `config.toml`, adjusting the path to this repository:
```toml
[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.
