🚀 MCP Packet Tracer

<p align="center"> <img src="demo/live-deploy.gif" alt="MCP Packet Tracer Demo" width="100%"> </p>

<p align="center">

</p>

---

Cisco Packet Tracer + Claude Desktop mediante MCP

Servidor MCP (Model Context Protocol) que integra Cisco Packet Tracer con Claude Desktop, permitiendo controlar Packet Tracer mediante lenguaje natural.

Con este proyecto Claude puede:

• Crear topologías automáticamente.
• Agregar routers, switches y PCs.
• Configurar protocolos de enrutamiento.
• Crear VLANs.
• Configurar DHCP.
• Ejecutar acciones directamente en Cisco Packet Tracer.
• Consultar la topología existente.
• Automatizar laboratorios de redes.

Todo desde Claude Desktop.

---

✨ Características

• Comunicación entre Claude Desktop y Cisco Packet Tracer.
• Creación automática de topologías.
• Automatización de laboratorios.
• Consulta de dispositivos.
• Ejecución de herramientas MCP.
• Integración mediante JSON-RPC.
• Compatible con Packet Tracer v9.
• Compatible con Claude Desktop.

---

📸 Demostraciones

Instalación

<p align="center">

<img src="demo/install-demo.gif" width="900">

</p>

---

Live Deploy

<p align="center">

<img src="demo/live-deploy.gif" width="900">

</p>

---

🏗 Arquitectura

                    Claude Desktop
                           │
                    Model Context Protocol
                           │
                    MCP Packet Tracer Server
                           │
                  Cisco Packet Tracer API
                           │
                 Cisco Packet Tracer (Live)

---

📂 Estructura del proyecto

MCP-Packet-Tracer
│
├── demo
│   ├── install-demo.gif
│   ├── live-deploy.gif
│   └── .gitkeep
│
├── GUIA Y SERVER MCP V4
│   ├── guia_mcp_packet_tracer.md
│   └── V4.0.pts
│
├── packet_tracer_mcp
│
├── pyproject.toml
│
├── README.md
│
└── LICENSE

---

⚙ Requisitos

• Windows 10 / 11
• Python 3.11 o superior
• Git
• Cisco Packet Tracer 8.2 o superior (recomendado v9)
• Claude Desktop

---

📥 Instalación

1. Clonar el repositorio

git clone https://github.com/lidisching-hue/mcp-packet-tracer.git

cd mcp-packet-tracer

---

2. Instalar el proyecto

pip install -e .

---

3. Configurar Claude Desktop

Agregar el servidor MCP en el archivo de configuración de Claude Desktop.

{
  "mcpServers": {
    "packet-tracer": {
      "command": "python",
      "args": [
        "-m",
        "packet_tracer_mcp",
        "--stdio"
      ]
    }
  }
}

---

4. Instalar la extensión de Packet Tracer

Dentro del repositorio encontrarás:

GUIA Y SERVER MCP V4/
    V4.0.pts

En Cisco Packet Tracer:

Extensions
    ↓
Scripting
    ↓
Configure PT Script Modules

Agregar

V4.0.pts

Luego iniciar

MCP-BUILDER

Debe aparecer:

PT Connected

---

5. Reiniciar Claude Desktop

Cerrar completamente Claude Desktop y volver a abrirlo.

---

6. Verificar la conexión

Ejemplo:

Lista todos los dispositivos disponibles usando pt_list_devices

Si Claude devuelve los dispositivos disponibles, el servidor MCP está funcionando correctamente.

---

💬 Ejemplos de uso

Crear una red:

Crea una red con 2 routers, 2 switches y 4 PCs.

---

Crear VLANs:

Configura VLAN 10 y VLAN 20 con enlaces Trunk.

---

Configurar OSPF

Crea una topología con OSPF y DHCP.

---

Configurar ACL

Bloquea el tráfico entre VLAN 10 y VLAN 20.

---

Consultar dispositivos

Lista todos los dispositivos disponibles.

---

🛠 Tecnologías

• Python
• FastMCP
• Cisco Packet Tracer API
• Claude Desktop
• Model Context Protocol (MCP)
• JSON-RPC

---

📁 Archivos incluidos

Archivo	Descripción
V4.0.pts	Módulo para Cisco Packet Tracer
guia_mcp_packet_tracer.md	Guía completa de instalación
install-demo.gif	Instalación paso a paso
live-deploy.gif	Demostración en funcionamiento

---

📖 Documentación

La guía completa de instalación se encuentra en:

GUIA Y SERVER MCP V4/
└── guia_mcp_packet_tracer.md

También incluye el módulo:

GUIA Y SERVER MCP V4/
└── V4.0.pts

La instalación, configuración de Claude Desktop, verificación del servidor MCP y carga del módulo V4.0.pts siguen los pasos documentados en la guía incluida en el proyecto. :contentReference[oaicite:1]{index=1}

---

👨‍💻 Autor

Lidis Chinguel Aponte

Ingeniero de Sistemas

GitHub:

https://github.com/lidisching-hue

---

⭐ Si este proyecto te resulta útil

Si este proyecto te ha sido de utilidad, considera darle una ⭐ al repositorio.

---

📄 Licencia

Este proyecto se distribuye con fines educativos y de investigación para la automatización de Cisco Packet Tracer mediante Model Context Protocol (MCP).