switch-console-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
switch-console-mcp
A small local MCP server that lets Claude (desktop app)
send CLI commands to a network switch over its serial console (USB/RS-232, e.g. COM5).
Tested with a Hirschmann GRS105 (HiOS-2A-10.3.03) on 9600-8-N-1, no flow control. It should work with most switches that use a plain text CLI over a console port.
Tools
Tool | What it does |
| Presses Enter on the console and returns what the switch shows (prompt / login banner). |
| Logs in if the switch asks (credentials from env vars), sends a list of CLI commands in order, and returns the full console output. Handles |
All console output is also appended to switch_console_log.txt next to the script.
Related MCP server: Netmiko MCP Server
Requirements
Windows / Linux / macOS with Python 3.10+
A console cable to the switch
Claude desktop app
pip install -r requirements.txtWorks with both mcp 1.x (FastMCP) and 2.x (MCPServer).
Setup
Copy
switch_console_mcp.pysomewhere on the machine that has the console cable.Add the server to your Claude desktop config (Windows:
%APPDATA%\Claude\claude_desktop_config.json). Seeclaude_desktop_config.example.json— add the"mcpServers"section as a top-level key next to any existing settings.Set the environment variables:
Variable
Default
Meaning
SWITCH_PORTCOM5Serial port (
COM5,/dev/ttyUSB0, …)SWITCH_BAUD9600Baud rate
SWITCH_USER(empty)
Login username
SWITCH_PASS(empty)
Login password
SWITCH_LOGswitch_console_log.txtOutput log path
Fully restart the Claude desktop app.
Close PuTTY / plink — only one program can hold the COM port at a time.
Example
Ask Claude: "Set the description SPARE on ports 1/1 to 1/7 and save."
Claude calls run_commands with:
enable
configure
interface 1/1
name SPARE
exit
...
exit
copy config running-config nvm
show port allSecurity notes
The password sits in plain text in the Claude desktop config. Use this on lab / test equipment, or use a dedicated low-privilege account.
Claude never sees the password — the server sends it to the switch itself.
This server gives Claude full CLI access to whatever is on the other end of the cable. Do not leave it connected to production equipment unattended.
Never commit your real
claude_desktop_config.json(it is in.gitignore).
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
I run shell commands on your private cloud environment (bash, sh, zsh)
Run social media from Claude: draft, schedule and approve posts, answer comments, read results.
Read and write NetSuite and run SuiteQL from Claude or ChatGPT. Write tools flagged for approval.
Related MCP Servers
- AlicenseBqualityCmaintenanceEnables SSH and UART/serial port access for Claude Code to directly control remote devices like Raspberry Pi, embedded systems, and IoT devices. Supports command execution, file transfers via SFTP, and serial communication.242AGPL 3.0
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Cisco network devices through SSH using Netmiko. Supports retrieving device status, interface details, configurations, and resource monitoring through natural language commands in Claude Desktop.-
- AlicenseNot gradedqualityDmaintenanceEnables Claude Code to interact with network devices over serial and SSH with command safety classification and a persistent knowledge base.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to interact with Cisco routers and switches over serial console connections, handling prompt detection and pagination.7MIT