Packet Tracer MCP

Tell your AI "create a network with 3 routers, OSPF and DHCP" — it plans, validates, generates, and deploys the topology directly into Cisco Packet Tracer in real time.

🌐 Website: https://www.mcpnetwork.top  •  📚 Documentation: https://mats2208.github.io/MCP-Packet-Tracer/

What it does

Related MCP server: packet-tracer-mcp

Configuraciones de laboratorio incluidas

Esta copia incluye proyectos de Cisco Packet Tracer listos para abrir en la carpeta projects/:

• topologia_RIP_5_routers.pkt: anillo de cinco routers con RIP v2, cinco LAN y dos PCs por LAN.

• topologia_excel_tipoA_tipoB.pkt: topología basada en el ejercicio de subneteo.

Consulta INSTALACION.md para instalar el MCP y CREDITOS.md para conocer la procedencia del código y las referencias utilizadas.

A Model Context Protocol (MCP) server para usar desde ChatGPT/Codex u otro cliente de chat compatible con MCP, con control programático de Cisco Packet Tracer.

👉 Full tool reference, device catalog, networking guides and architecture live in the documentation site.

Installation

1. Install the server

git clone https://github.com/Arminfx7/mcp-packet-tracer-configurado
cd mcp-packet-tracer-configurado
python -m venv .venv
# Windows PowerShell: .\\.venv\\Scripts\\Activate.ps1
# Linux/macOS: source .venv/bin/activate
pip install -e .

2. Conecta tu cliente de chat

En ChatGPT/Codex o en otro cliente de chat compatible con MCP, registra el servidor local con esta configuración:

{
  "mcpServers": {
    "packet-tracer": {
      "command": "C:/ruta/al/repositorio/.venv/Scripts/python.exe",
      "args": ["-m", "packet_tracer_mcp", "--stdio"],
      "cwd": "C:/ruta/al/repositorio"
    }
  }
}

En Linux/macOS usa .venv/bin/python. La ruta debe apuntar a la carpeta donde clonaste este repositorio.

3. Install the live-deploy extension — only if you want real-time deploy into a running Packet Tracer

Download V5.pts from Releases, then in Packet Tracer go to Extensions → Scripting → Configure PT Script Modules → Add… and select it. Full walkthrough in Live deploy below.

v0.6.0+ requires V5. The bridge now authenticates with a per-machine token that the V5 extension reads automatically; builds before V5 can't authenticate.

4. Usa el chat para solicitar la topología

Ejemplo de prompt:

Crea una topología RIP v2 con cinco routers en anillo, cinco switches y dos PCs por LAN. Usa las IP indicadas en el Excel, configura las interfaces, agrega etiquetas de IP y verifica con ping.

Consulta INSTALACION.md para la configuración completa. Requiere Python 3.11+.

Quick start

Just talk to your AI:

"Build a network with 2 routers, 2 switches, 4 PCs, DHCP and static routing."

The LLM calls pt_full_build, which plans → validates → generates → deploys. See the Quick Start guide.

Live deploy

Stream topologies into a running Packet Tracer in real time. Install this repo's own MCP Control Center extension once — the .pts from Releases — via Extensions → Scripting → Configure PT Script Modules → Add…, then open Extensions → MCP BUILDER. It auto-connects to the bridge — no snippet to paste.

📖 Full steps → Live Deploy Setup.

Credits & Acknowledgements

Live deploy runs through our own Packet Tracer extension — the MCP Control Center (the .pts in Releases). Its Script-Engine helper layer was inspired by PTBuilder by Kim Knight (@kimmknight), who pioneered driving Packet Tracer's Script Engine from JavaScript — thanks for the groundwork. 🙏

PTBuilder and Packet Tracer MCP are separate, independent projects. You install our extension, not PTBuilder. Full Credits & Attribution.

Security

The live-deploy bridge requires a per-machine token as of v0.6.0. Earlier versions had an unauthenticated bridge — any web page open while Packet Tracer was running could execute code inside it. Upgrade.

Found a vulnerability? Report it privately via GitHub Security Advisories, not a public issue. SECURITY.md also documents the threat model — worth reading before reporting, since some behaviour (like pt_send_raw executing arbitrary JavaScript) is deliberate.

Contributing

See CONTRIBUTING.md. Tests run offline with python -m pytest; no Packet Tracer needed.

License

Released under the MIT License — © 2026 Mateo (@Mats2208).

Built with MCP · Powered by Pydantic · Deploys to Cisco Packet Tracer · Script-engine logic inspired by PTBuilder

If this project is useful to you, star it ⭐ and share it with the community.