Skip to main content
Glama
mcp-rs232
by daedalus

mcp-rs232

An MCP server that exposes RS232 serial port connectivity

PyPI Python Ruff

mcp-name: io.github.daedalus/mcp-rs232

Install

pip install mcp-rs232

Related MCP server: embedded-serial-mcp

Usage

from mcp_rs232 import list_ports, open_port, close_port, read_port, write_port

# List available ports
ports = list_ports()
print(ports)

# Open a port
open_port("COM1", baud_rate=9600)

# Write data (hex encoded)
write_port("COM1", "48656c6c6f")  # "Hello"

# Read data (returns hex encoded)
data = read_port("COM1")

# Close the port
close_port("COM1")

CLI

mcp-rs232 --help

API

Resources

  • serial://ports - Lists all available serial ports with their details

  • serial://port/{port_name} - Get details about a specific port

Tools

  • list_ports_tool() - Returns list of available serial ports

  • open_port(port, baud_rate, ...) - Opens a serial connection

  • close_port(port) - Closes a serial connection

  • read_port(port, size, timeout) - Reads data from port (hex encoded)

  • write_port(port, data) - Writes hex-encoded data to port

  • get_port_config(port) - Returns current port configuration

Development

git clone https://github.com/daedalus/mcp-rs232.git
cd mcp-rs232
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Available Tools

6 tools
close_portB

Close an open serial port connection.

Inputs: port (required). Returns: result

get_port_configB

Get the current configuration of an open serial port.

Inputs: port (required). Returns: object

list_ports_toolA

Tool to list all available serial ports.

Returns: List of available serial ports with their details.

Inputs: no named parameters. Returns: result

open_portC

Open a serial port connection.

Inputs: port (required), baud_rate, parity, stop_bits, +2 more. Returns: result

read_portC

Read data from an open serial port.

Inputs: port (required), size, timeout. Returns: result

write_portB

Write data to an open serial port.

Inputs: port (required), data (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a distinct purpose: listing, opening, closing, configuring, reading, and writing serial ports. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in snake_case (e.g., close_port, get_port_config). The naming is predictable and clear.

    Tool Count5/5

    Six tools cover the essential operations for serial port management without being excessive. The count is well-scoped for the domain.

    Completeness4/5

    Core lifecycle operations are present (list, open, close, read, write, get config). A minor gap is the lack of a set_config tool for modifying port settings, but agents can work around this.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server that exposes RS485 bus connectivity, enabling AI assistants to read and write serial data to RS485 devices through tools like list_ports, connect_rs485, and read_rs485.
      73 PyPI
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A professional MCP server for serial port communication, enabling AI assistants to list, connect, send/receive data, and manage serial connections with embedded systems, IoT devices, and hardware debugging hardware.
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP server for serial ports — non-blocking reads, DTR/RTS, streaming subscriptions, port allowlist.
      20
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      MCP server for serial port communication. Provides tools to open, read, write, and manage serial ports through the Model Context Protocol.
      10
      40 PyPI
      -