rs232-mcp
Provides tools for communicating with Cisco network equipment over RS232 serial console connections, enabling AI assistants to send commands, handle pagination, and manage connection lifecycle.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rs232-mcp connect to COM1 and show running-config"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude Code
claude mcp add rs232 -- npx github:xnetcat/rs232-mcpTo add it to a specific project instead of globally:
claude mcp add --scope project rs232 -- npx github:xnetcat/rs232-mcpManual 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 available serial ports on the system |
| Open a serial connection (path, baudRate, dataBits, stopBits, parity) |
| Close an open serial connection |
| Send a command and wait for Cisco prompt. Handles |
| Write raw string data to a port (no prompt waiting) |
| Read buffered data from a port (non-blocking) |
| 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 portThe send_command tool automatically:
Sends the command with CRLF
Waits for a Cisco prompt (
Router#,Switch>,Router(config)#, etc.)Presses space through
-- More --promptsStrips 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_portsreturns the identifier to use withopen_port, so you usually do not need any path conversion.The runtime uses the
serialportpackage directly, so Windows port handling follows the nativeCOMxbehavior provided by that library.
Development
git clone https://github.com/xnetcat/rs232-mcp.git
cd rs232-mcp
npm install
npm run build
npm testLicense
MIT
Available Tools
7 toolsclose_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
Scored across 7 tools
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.
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.
Seven tools is well-scoped for a serial port server, covering essential operations without redundancy or bloat. Each tool earns its place.
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
Related MCP Connectors
AI network lab: build and validate real multi-vendor router and switch labs from a prompt.
AI helper for choosing and speccing network & security products from Cisco, Arista, Juniper and more
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Network hardware BOMs, built inside your AI assistant
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables 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-
- AlicenseAqualityDmaintenanceEnables AI assistants to communicate with serial port devices, supporting port management, data transmission in text/binary modes, interactive terminal sessions, and automatic reconnection.1412MIT
- FlicenseNot gradedqualityDmaintenanceEnables 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.-
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with serial port devices by sending commands, capturing output, and managing connections, with real-time browser-based terminal monitoring.1MIT