Cisco Cli MCP

🚀 Cisco CLI MCP Server

Cisco CLI MCP Server是一个基于Telnet协议的MCP工具，专为思科IOS网络设备的CLI操作进行了优化。它能帮助用户更高效地管理和配置思科网络设备。

🚀 快速开始

安装

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

运行

作为MCP服务器运行

cisco-cli-mcp

配置MCP客户端

在MCP客户端配置文件中添加：

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

✨ 主要特性

• 智能连接管理：自动激活终端、TCP预热、自动禁用分页。
• 设备模式检测：自动识别用户模式、特权模式、配置模式。
• 智能等待机制：检测到设备提示符立即返回，无需等满超时时间。
• 耗时命令优化：自动检测ping、traceroute等命令并增加等待时间。

💻 使用示例

基础用法

建立Telnet连接

# 使用telnet_connect工具建立Telnet连接，返回会话ID和设备当前模式
# 调用telnet_connect建立连接
{
  "success": true,
  "sessionId": "xxx-xxx-xxx",
  "deviceMode": "SW3#",
  "message": "连接成功"
}

在指定会话执行命令

# 使用telnet_execute工具在指定会话执行命令，返回输出和设备模式
# 调用telnet_execute执行命令
{
  "success": true,
  "output": "命令输出内容...",
  "deviceMode": "SW3#"
}

📚 详细文档

工具列表

• telnet_connect：建立Telnet连接，返回会话ID和设备当前模式。
• telnet_execute：在指定会话执行命令，返回输出和设备模式。
• telnet_list_sessions：列出所有活动会话。
• telnet_disconnect：断开指定会话。

返回格式

telnet_connect

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

telnet_execute

{
  "success": true,
  "output": "命令输出内容...",
  "deviceMode": "SW3#"
}

🔧 技术细节

系统提示

你是思科网络设备配置助手，擅长配置路由器交换机

1、你可以使用cisco-cli-mcp工具连接设备
2、对于耗时操作如 ping、traceroute、show tech-support 等，建议将此值设置为 3000-10000 毫秒或更长时间。
3、你每次发送命令的时候，务必记住当前的系统模式（例如特权模式、全局配置模式等）配置命令要根据模式进行调整（如在全局配置模式，执行show操作要加上do，在特权模式执行配置操作要configure terminal等。
4、如果之前已经连接成功的话，可以使用telnet_list_sessions工具复用之前的会话，避免二次连接
5、你不确定的配置要执行show操作进行确定再配置
6、所有的配置要结合用户给出的拓扑信息，有不清楚的地方可以反问用户。
7、如果提示命令错误，可以使用“?”命令查看提示
8、你调用工具的之前必须得简单解释一下（不需要解释太多）