Cisco MCP Server

English | 中文

---

English

A comprehensive MCP (Model Context Protocol) server for Cisco device management via SSH/Telnet. Execute commands and manage Cisco routers, switches, and firewalls through AI assistants like Claude and Amazon Q.

✨ Features

• 🔌 Dual Protocol Support: Connect via SSH or Telnet
• 🔄 Persistent Connections: Maintain long-lived connections for efficient command execution
• 🎯 Universal Command Execution: Execute any Cisco command through a single interface
• 🔐 Mode Management: Automatic switching between user, enable, and configuration modes
• 🌐 Multi-Device Support: Manage multiple Cisco devices simultaneously
• 🤖 AI-Friendly: Natural language command translation through AI assistants
• 📊 Connection Monitoring: Track active connections and their status

🚀 Quick Start

1. Clone and Install

   git clone https://github.com/very99/cisco-mcp.git
   cd cisco-mcp
   npm install
   

2. Build the Project

   npm run build
   

3. Configure MCP Client

   Add to your MCP configuration (e.g., Claude Desktop):

   {
     "mcpServers": {
       "cisco-mcp": {
         "command": "node",
         "args": ["/path/to/cisco-mcp/dist/index.js"]
       }
     }
   }
   

🛠 Available Tools

connect_cisco_device

Establish a connection to a Cisco device.

Parameters:

• host (required): IP address or hostname
• username (required): Authentication username
• password (required): Authentication password
• protocol (optional): “ssh” or “telnet” (default: “ssh”)
• port (optional): Custom port number
• enable_password (optional): Enable password for privileged mode

Example:

{
  "host": "192.168.1.1",
  "username": "admin",
  "password": "password123",
  "protocol": "ssh",
  "enable_password": "enable123"
}

execute_cisco_command

Execute a command on a connected Cisco device.

Parameters:

• host (required): Target device IP/hostname
• command (required): Cisco command to execute
• mode (optional): “user”, “enable”, or “config” (default: “user”)

Example:

{
  "host": "192.168.1.1",
  "command": "show version",
  "mode": "user"
}

disconnect_cisco_device

Disconnect from a Cisco device.

Parameters:

• host (required): Device IP/hostname to disconnect

list_connections

List all active connections.

💡 Usage Examples

Basic Device Information

AI: "Connect to router 192.168.1.1 and show me the device information"

The AI will:

1. Use connect_cisco_device to establish connection
2. Use execute_cisco_command with “show version”

Interface Configuration

AI: "Configure interface GigabitEthernet0/1 with IP 10.1.1.1/24"

The AI will:

1. Use execute_cisco_command with mode “config”
2. Execute: “interface GigabitEthernet0/1”
3. Execute: “ip address 10.1.1.1 255.255.255.0”