cisco-mcp

very99/cisco-mcp

3.3

If you are the rightful owner of cisco-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A comprehensive MCP (Model Context Protocol) server for Cisco device management via SSH/Telnet.

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"
Network Troubleshooting
AI: "Check the routing table and interface status on the core switch"

The AI will execute multiple commands:

  • "show ip route"
  • "show ip interface brief"
  • "show interface status"

🔧 Supported Cisco Commands

This MCP server supports all Cisco IOS commands, including but not limited to:

Show Commands
  • show version - Device information
  • show running-config - Current configuration
  • show ip interface brief - Interface summary
  • show ip route - Routing table
  • show vlan brief - VLAN information
  • show interface status - Interface status
  • show cdp neighbors - CDP neighbors
  • show mac address-table - MAC address table
Configuration Commands
  • configure terminal - Enter configuration mode
  • interface <interface> - Configure interface
  • ip address <ip> <mask> - Set IP address
  • no shutdown - Enable interface
  • vlan <vlan-id> - Create/configure VLAN
  • router ospf <process-id> - Configure OSPF
Diagnostic Commands
  • ping <destination> - Test connectivity
  • traceroute <destination> - Trace route
  • show tech-support - Technical support information

🔒 Security Notes

  • This tool is designed for network automation and management
  • Credentials are passed per connection and not stored
  • Use appropriate network security practices
  • Consider using SSH keys for enhanced security (future enhancement)

🏗 Architecture

AI Assistant (Claude/Amazon Q)
    ↓ Natural Language
MCP Client
    ↓ Tool Calls
Cisco MCP Server
    ↓ SSH/Telnet
Cisco Devices (Routers/Switches/Firewalls)

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the file for details.

中文

一个全面的MCP（模型上下文协议）服务器，用于通过SSH/Telnet管理Cisco设备。通过Claude和Amazon Q等AI助手执行命令并管理Cisco路由器、交换机和防火墙。

✨ 功能特性

  • 🔌 双协议支持: 支持SSH或Telnet连接
  • 🔄 持久连接: 维护长连接以实现高效的命令执行
  • 🎯 通用命令执行: 通过单一接口执行任何Cisco命令
  • 🔐 模式管理: 自动在用户、特权和配置模式之间切换
  • 🌐 多设备支持: 同时管理多个Cisco设备
  • 🤖 AI友好: 通过AI助手进行自然语言命令转换
  • 📊 连接监控: 跟踪活动连接及其状态

🚀 快速开始

  1. 克隆并安装

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

  2. 构建项目

    npm run build

  3. 配置MCP客户端

    添加到您的MCP配置中（例如Claude Desktop）：

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

🛠 可用工具

connect_cisco_device

建立到Cisco设备的连接。

execute_cisco_command

在已连接的Cisco设备上执行命令。

disconnect_cisco_device

断开与Cisco设备的连接。

list_connections

列出所有活动连接。

💡 使用示例

基本设备信息
AI: "连接到路由器192.168.1.1并显示设备信息"
接口配置
AI: "配置接口GigabitEthernet0/1的IP为10.1.1.1/24"
网络故障排除
AI: "检查核心交换机的路由表和接口状态"

🔧 支持的Cisco命令

此MCP服务器支持所有Cisco IOS命令，包括但不限于：

  • 显示命令（show commands）
  • 配置命令（configuration commands）
  • 诊断命令（diagnostic commands）

📝 许可证

本项目采用MIT许可证 - 详见文件。