cisco-pt-mcp 🚀

Automatización de Cisco Packet Tracer con IA - Permite que los clientes de IA controlen Packet Tracer con lenguaje natural. Servidor MCP de código abierto con integración con Gemini AI.

✨ Características

• 🤖 Generación de redes con IA - Describe redes en lenguaje natural y obtén topologías funcionales

• 🎨 Interfaz de construcción visual - Editor web con resaltado de sintaxis

• 📦 Plantillas prediseñadas - Campus, sucursal, VLAN y configuraciones de enrutamiento

• 🔌 Protocolo MCP -Funciona con Claude Desktop, Cursor y otros clientes MCP

• ⚡ Control en tiempo real - Puente directo hacia la instancia de Packet Tracer en ejecución

• 🛠️ Conjunto completo de herramientas - Más de 20 herramientas para gestión de dispositivos, configuración y pruebas

Related MCP server: packet-tracer-mcp

📥 Instalación rápida

1. Instalar el servidor MCP

# Clone or download this repository
cd cisco-pt-mcp

# Install with AI support
pip install -e ".[ai]"

# Configure Gemini API (optional, for AI features)
python setup_config.py

2. Instalar la extensión de Packet Tracer

1. Abre Cisco Packet Tracer

2. Extensiones → Scripting → Configurar módulos de script de PT

3. Haz clic en Añadir → Selecciona extension/cisco-pt-mcp.pts

4. Reinicia Packet Tracer

3. Iniciar y conectar

# Start the MCP server
python -m mcp_server

En Packet Tracer:

• Haz clic en Extensiones → Packet Tracer MCP

• El estado debe mostrar "MCP Connected"

📖 Consulta QUICKSTART.md para obtener instrucciones detalladas

🎯 Modos de uso

Modo 1: Generador con IA - language natural

Abre la interfaz de PTBuilder en Packet Tracer y usa la pestaña Generador de IA:

"Create a corporate network with 1 edge router, 1 core switch, 
2 department switches, and 3 PCs per department. Configure VLANs."

Haz clic en Generar → ¡La red aparece en el área de trabajo!

Modo 2: Editor de código (JavaScript)

Escribe código PTBuilder directamente:

addDevice("R1", "2911", 150, 150);
addDevice("S1", "2960-24TT", 350, 150);
addLink("R1", "GigabitEthernet0/0", "S1", "GigabitEthernet0/1", "straight");
configureIosDevice("R1", "interface Gi0/0\nip address 192.168.1.1 255.255.255.0");

Modo 3: Cliente MCP (Claude/Cursor)

Configura tu cliente MCP:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cisco-pt-mcp": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/cisco-pt-mcp",
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

Luego conversa con Claude:

"Crea un laboratorio de red para probar el enrutamiento OSPF con 3 routers"

🛠️ Herramientas disponibles

Herramientas impulsadas por IA

Herramientas básicas de red

Herramientas de configuración

Herramientas de monitorización y simulación

📚 Documentación

• QUICKSTART.md - Ponte en marcha en 5 minutos

• SETUP_GUIDE.md - Guía completa de configuración y uso

• packet-tracer-automation-doc.md - Técnicas avanzadas de automatización

🎓 Ejemplos

Ejemplo 1: Red simple con IA

Prompt: "Create a basic network with one 2911 router, one 2960 switch, 
and two PCs. Configure the router with IP 192.168.1.1 and the PCs 
with static IPs in the same subnet."

Result: Complete working network in 30 seconds

Ejemplo 2: Plantilla de red de campus

Carga la plantilla "Campus Network" desde la pestaña Plantillas:

• Arquitectura de 3 niveles (núcleo, distribución, acceso)

• 1 switch de núcleo

• 2 switches de distribución

• 4 switches de acceso

• Conexiones entre switches correctas

Ejemplo 3: Configuración de VLAN

// From templates - VLAN setup
addDevice("S1", "2960-24TT", 300, 200);
addDevice("PC1", "PC-PT", 150, 300);
addDevice("PC2", "PC-PT", 450, 300);

configureIosDevice("S1", `
vlan 10
name Sales
vlan 20
name Engineering

interface FastEthernet0/1
switchport mode access
switchport access vlan 10

interface FastEthernet0/2
switchport mode access
switchport access vlan 20
`);

🔧 Configuración

Configuración de la API de Gemini

Opción 1: Interactiva

python setup_config.py

Opción 2: Variable de entorno

export GEMINI_API_KEY="your_key_here"

Opción 3: Archivo de configuración Crea ~/.cisco-pt-mcp/config.json:

{
  "gemini_api_key": "YOUR_KEY_HERE",
  "bridge_host": "127.0.0.1",
  "bridge_port": 7531,
  "tool_timeout": 60
}

🏗️ Arquitectura

┌─────────────────┐
│   MCP Client    │  (Claude Desktop, Cursor, etc.)
│  (Natural Lang) │
└────────┬────────┘
         │ MCP Protocol
┌────────▼────────┐
│   MCP Server    │  (Python)
│   + Gemini AI   │  - Network generation
│                 │  - Code generation
└────────┬────────┘
         │ Socket.IO (port 7531)
┌────────▼────────┐
│ PT Extension    │  (JavaScript)
│  cisco-pt-mcp   │  - PTBuilder integration
│                 │  - Web interface
└────────┬────────┘
         │ IPC API
┌────────▼────────┐
│ Packet Tracer   │  (Cisco Application)
│   Workspace     │
└─────────────────┘

🤝 Contribuciones

¡Contribuciones bienvenidas! Este proyecto integra:

• Model Context Protocol (MCP)

• PTBuilder - Automatización JavaScript para Packet Tracer

• Gemini API - Generación de redes con IA

📄 Licencia

Licencia MIT: consulta el archivo LICENSE

🙏 Agradecimientos

• PTBuilder por kimmknight - Marco de automatización en JavaScript

• Protocolo MCP - Estándares para la comunicación entre aplicaciones e IA

• Google - Capacidades de generación con IA

• Original cisco-pt-mcp de muhammadbalawal

🆘 Soporte e incidencias

• Solución de problemas: Consulta SETUP_GUIDE.md

• Incidencias: Abrir un issue en GitHub

• Documentación: Revisa la carpeta de documentación

¡Da una estrella ⭐ a este repositorio si te resulta útil!