Skip to main content
Glama

rs232-mcp

MCP server for RS232 serial communication with Cisco network equipment.

Lets AI assistants interact with Cisco routers and switches over serial console connections. Handles prompt detection, -- More -- pagination, and connection lifecycle management.

Supported platforms: macOS, Linux, and Windows.

Install

Codex

codex mcp add rs232 -- npx github:xnetcat/rs232-mcp

Claude Code

claude mcp add rs232 -- npx github:xnetcat/rs232-mcp

To add it to a specific project instead of globally:

claude mcp add --scope project rs232 -- npx github:xnetcat/rs232-mcp

Manual configuration

For any stdio MCP client, configure the server command like this:

{
  "mcpServers": {
    "rs232": {
      "command": "npx",
      "args": ["github:xnetcat/rs232-mcp"]
    }
  }
}

If your Windows client does not resolve npm shims correctly, use npx.cmd as the command instead of npx.

Related MCP server: UART MCP Server

Tools

Tool

Description

list_ports

List available serial ports on the system

open_port

Open a serial connection (path, baudRate, dataBits, stopBits, parity)

close_port

Close an open serial connection

send_command

Send a command and wait for Cisco prompt. Handles -- More -- pagination automatically

write_raw

Write raw string data to a port (no prompt waiting)

read_buffer

Read buffered data from a port (non-blocking)

get_connections

List all open connections and their settings

Example usage

Once configured, your AI assistant can:

> List serial ports
> Open /dev/tty.usbserial-110 at 9600 baud
> Open COM3 at 9600 baud
> Send "show version"
> Send "show running-config"
> Close the port

The send_command tool automatically:

  • Sends the command with CRLF

  • Waits for a Cisco prompt (Router#, Switch>, Router(config)#, etc.)

  • Presses space through -- More -- prompts

  • Strips the echoed command from output

  • Returns clean output

Default serial settings

Parameter

Default

Baud rate

9600

Data bits

8

Stop bits

1

Parity

none

Windows notes

  • Serial ports usually appear as COM3, COM4, COM10, and similar names.

  • list_ports returns the identifier to use with open_port, so you usually do not need any path conversion.

  • The runtime uses the serialport package directly, so Windows port handling follows the native COMx behavior provided by that library.

Development

git clone https://github.com/xnetcat/rs232-mcp.git
cd rs232-mcp
npm install
npm run build
npm test

License

MIT

Available Tools

7 tools
close_portA

Close an open serial connection

Inputs: path (required).

get_connectionsA

List all open serial connections and their settings

Inputs: no named parameters.

list_portsB

List available serial ports

Inputs: no named parameters.

open_portC

Open a serial connection to a device

Inputs: path (required), parity, baudRate, dataBits, +1 more.

read_bufferA

Read buffered data from a serial port (non-blocking)

Inputs: path (required).

send_commandA

Send a command to a Cisco device and wait for the prompt. Handles -- More -- pagination automatically.

Inputs: path (required), command (required), timeout.

write_rawA

Write raw string data to a serial port (no prompt waiting). Supports escape sequences: \r \n \t \x03 (Ctrl+C) etc.

Inputs: data (required), path (required).

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: enumerate ports, open/close connections, send command with prompt handling, write raw data, read buffered data, and list connections. No overlap between send_command and write_raw; they handle different interaction modes.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (e.g., list_ports, open_port, read_buffer). The convention is uniform and predictable.

    Tool Count5/5

    Seven tools is well-scoped for a serial port server, covering essential operations without redundancy or bloat. Each tool earns its place.

    Completeness5/5

    The surface covers the full serial port lifecycle: enumeration, open/close, command/raw writing, buffered reading, and connection monitoring. No obvious gaps for typical serial interaction workflows.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables AI assistants to interact with physical serial port devices across platforms (Windows COM/Linux tty) with support for asynchronous communication, URC pattern recognition, and structured logging.
      1
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to communicate with serial port devices, supporting port management, data transmission in text/binary modes, interactive terminal sessions, and automatic reconnection.
      14
      12
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to interact with Cisco IOS-XE network devices over SSH using structured tools. Provides read and write capabilities for network management with built-in validation and security.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to interact with serial port devices by sending commands, capturing output, and managing connections, with real-time browser-based terminal monitoring.
      1
      MIT