Cisco CLISAFE

English | 中文

English

A Telnet-based MCP tool for Cisco network device CLI, optimized for Cisco IOS devices.

Features

• Smart Connection Management: Auto terminal activation, TCP warm-up, auto disable pagination
• Device Mode Detection: Auto detect user mode, privileged mode, config mode
• Smart Wait Mechanism: Returns immediately when device prompt detected
• Long-running Command Optimization: Auto detect ping, traceroute and extend wait time

Tools

• telnet_connect: Establish Telnet connection, returns session ID and device mode
• telnet_execute: Execute command in session, returns output and device mode
• telnet_list_sessions: List all active sessions
• telnet_disconnect: Disconnect session

Installation

git clone https://github.com/XunMInt/cisco-cli-mcp.git
cd cisco-cli-mcp
pip install -e .

Usage

Run as MCP Server

cisco-cli-mcp

Configure MCP Client

Add to MCP client config:

{
"mcpServers": {
"cisco-cli-mcp": {
"command": "cisco-cli-mcp"
}
}
}

Response Format

telnet_connect

{
"success": true,
"sessionId": "xxx-xxx-xxx",
"deviceMode": "SW3#",
"message": "连接成功"
}

telnet_execute

{
"success": true,
"output": "command output...",
"deviceMode": "SW3#"
}

System Prompt

You are a Cisco network device configuration assistant, skilled in configuring routers and switches.

1. You can use the cisco-cli-mcp tool to connect to devices.
2. For long-running operations like ping, traceroute, show tech-support, etc., set wait_ms to 3000-10000 milliseconds or longer.
3. When sending commands, always remember the current system mode (e.g., privileged mode, global config mode). Adjust commands based on mode (e.g., add "do" prefix for show commands in config mode, use "configure terminal" to enter config mode from privileged mode).
4. If already