MCP Packet Tracer

Servidor MCP (Model Context Protocol) que conecta Claude con Cisco Packet Tracer 9.x mediante su REST API. Permite controlar topologías de red, configurar dispositivos con comandos IOS y ejecutar diagnósticos directamente desde Claude.

Arquitectura

MCP Packet Tracer/
├── mcpApp.py                      # Entry point — servidor MCP (15 herramientas)
├── models/
│   ├── device.py                  # Device, Interface, DeviceType
│   ├── link.py                    # Link, LinkType
│   └── network.py                 # Network (topología completa)
├── views/
│   ├── device_view.py             # Formateo de dispositivos para Claude
│   └── network_view.py            # Formateo de topología y conexiones
├── controllers/
│   ├── device_controller.py       # CRUD de dispositivos
│   ├── network_controller.py      # Topología y conexiones
│   └── command_controller.py      # CLI IOS y diagnósticos
├── services/
│   └── packet_tracer_service.py   # Cliente HTTP → PT REST API
└── requirements.txt

El patrón MVC separa responsabilidades:

Requisitos

• Python 3.10+ (probado en 3.11.9)

• Cisco Packet Tracer 9.x con REST API habilitada en el puerto 39000

• Claude Desktop o Claude Code (extensión VS Code)

Instalación

1. Clonar el repositorio

git clone https://github.com/mainorcruz/MCP_Packet_Tracer.git
cd MCP_Packet_Tracer

2. Crear entorno virtual con Python 3.11

py -3.11 -m venv .venv

3. Instalar dependencias

.venv\Scripts\pip install -r requirements.txt

4. Verificar que el servidor carga correctamente

.venv\Scripts\python -c "from mcpApp import mcp; print('OK —', len(mcp._tool_manager._tools), 'herramientas')"

Configuración en Claude

Claude Desktop

Edita o crea %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "packet-tracer": {
      "command": "C:\\ruta\\al\\proyecto\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\ruta\\al\\proyecto\\mcpApp.py"
      ]
    }
  }
}

Claude Code (VS Code)

Edita ~\.claude\settings.json:

{
  "mcpServers": {
    "packet-tracer": {
      "command": "C:\\ruta\\al\\proyecto\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\ruta\\al\\proyecto\\mcpApp.py"
      ]
    }
  }
}

Reemplaza C:\\ruta\\al\\proyecto con la ruta absoluta donde clonaste el repositorio.

Habilitar la REST API en Packet Tracer

1. Abre Packet Tracer 9.x

2. Ve a Edit → Preferences → API

3. Activa la opción Enable API

4. Confirma que el puerto sea 39000

5. Reinicia Packet Tracer si es necesario

Herramientas disponibles

Una vez activo el servidor, Claude tiene acceso a las siguientes herramientas:

Diagnóstico

Dispositivos

Red y Conexiones

CLI y Diagnósticos

Ejemplos de uso con Claude

Ver la topología:

"Muéstrame todos los dispositivos de la red"

Configurar una interfaz:

"Configura la interfaz GigabitEthernet0/0 del Router0 con IP 192.168.1.1 y máscara 255.255.255.0"

Claude ejecutará internamente:

execute_config_block(
  device="Router0",
  commands=[
    "configure terminal",
    "interface GigabitEthernet0/0",
    "ip address 192.168.1.1 255.255.255.0",
    "no shutdown",
    "end"
  ]
)

Probar conectividad:

"Haz un ping desde PC0 a 192.168.1.1"

Conectar dos dispositivos:

"Conecta el Router0 (Gig0/1) con el Switch0 (Fa0/1) usando cable directo"

Tipos de dispositivos soportados

Router · Switch · PC · Server · WirelessRouter · AccessPoint · Firewall

Tipos de cable soportados

CopperStraight · CopperCrossover · Fiber · Serial · Wireless

Dependencias

Licencia

MIT