Cisco Cli MCP

🚀 Cisco CLI MCP Server

CiscoネットワークデバイスのCLI用のTelnetベースのMCPツールで、Cisco IOSデバイスに最適化されています。

🚀 クイックスタート

Cisco CLI MCP Serverは、CiscoネットワークデバイスのCLI操作を支援するツールです。以下に、その使い方を説明します。

✨ 主な機能

• スマート接続管理：自動ターミナルアクティベーション、TCPウォームアップ、自動ページネーション無効化
• デバイスモード検出：自動的にユーザーモード、特権モード、設定モードを検出
• スマート待機メカニズム：デバイスのプロンプトを検出するとすぐに返される
• 長時間実行コマンドの最適化：ping、tracerouteを自動検出し、待機時間を延長

📦 インストール

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"
    }
  }
}

高度な使用法

返却形式

telnet_connect

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

telnet_execute

{
  "success": true,
  "output": "コマンド出力内容...",
  "deviceMode": "SW3#"
}

📚 ドキュメント

システムプロンプト

あなたはCiscoネットワークデバイスの設定アシスタントで、ルーターやスイッチの設定に精通しています。

1. cisco-cli-mcpツールを使用してデバイスに接続することができます。
2. ping、traceroute、show tech-supportなどの長時間実行される操作の場合、wait_msを3000 - 10000ミリ秒またはそれ以上に設定してください。
3. コマンドを送信する際は、常に現在のシステムモード（特権モード、グローバル設定モードなど）を覚えておき、モードに応じてコマンドを調整してください（設定モードでshowコマンドを実行する場合は「do」を接頭辞として追加し、特権モードから設定モードに入る場合は「configure terminal」を使用します）。
4. すでに接続されている場合は、telnet_list_sessionsを使用して既存のセッションを再利用し、再接続を避けてください。
5. 設定がわからない場合は、変更を加える前にshowコマンドを実行して確認してください。
6. すべての設定は、ユーザーが提供するトポロジ情報に基づいて行ってください。不明な点がある場合は、ユーザーに確認してください。
7. コマンドエラーが発生した場合は、「?」コマンドを使用して利用可能なオプションを確認してください。
8. ツールを呼び出す前に、行うことを簡単に説明してください（長い説明は必要ありません）。

🔧 技術詳細

ツール一覧

• telnet_connect: Telnet接続を確立し、セッションIDとデバイスの現在のモードを返します。
• telnet_execute: 指定されたセッションでコマンドを実行し、出力とデバイスモードを返します。
• telnet_list_sessions: すべてのアクティブなセッションをリストします。
• telnet_disconnect: 指定されたセッションを切断します。