# 🚀 MCP Packet Tracer

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

<p align="center">

![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=for-the-badge&logo=python&logoColor=white)
![Cisco](https://img.shields.io/badge/Cisco-Packet%20Tracer-1BA0D7?style=for-the-badge&logo=cisco&logoColor=white)
![Claude Desktop](https://img.shields.io/badge/Claude-Desktop-orange?style=for-the-badge)
![MCP](https://img.shields.io/badge/Model_Context_Protocol-MCP-success?style=for-the-badge)

</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

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

---

# 📂 Estructura del proyecto

```text
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

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

cd mcp-packet-tracer
```

---

## 2. Instalar el proyecto

```bash
pip install -e .
```

---

## 3. Configurar Claude Desktop

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

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

---

## 4. Instalar la extensión de Packet Tracer

Dentro del repositorio encontrarás:

```text
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:

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

También incluye el módulo:

```text
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).