Skip to main content
Glama
UART MCP Server

UART MCP Server

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.

Related MCP server: uart-mcp

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      A headless MCP server that enables AI tools (like Claude Code) to read and analyze serial logs from embedded boards (ESP32, STM32) for firmware debugging, with read-only tools for log retrieval and a built-in web viewer.
      6
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables local UART and serial-port debugging through MCP, providing persistent capture, log search, regex/event monitoring, HEX send/query, protocol parsing, and shell-like command sequences.
      15
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to interact with physical embedded target boards over a dual-CDC USB bridge using MCP tools. It exposes console reading, pattern waiting, command sending, reboot/login state machines, and in-RAM MicroPython execution while a single-owner daemon safely arbitrates access to the serial devices.
      6
      4
      Apache 2.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables MCP clients to list serial ports, open sessions, send firmware commands, read and filter output, and safely flash STM32 or ESP32 boards with explicit confirmation and allow-listed firmware paths.
      10
      MIT