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、你調用工具的之前必須得簡單解釋一下（不需要解釋太多）