Skip to main content
Glama

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.

Version Python Pydantic v2 MCP Website Docs License

MCP Registry

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



What it does

Related MCP server: Packet Tracer MCP Server

Configuraciones de laboratorio incluidas

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

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.

Feature

Details

Planning

Natural language → topology

A single prompt becomes a complete TopologyPlan

IP / DHCP

Auto /24 LANs + /30 links, DHCP pools

Sequential, gateway at .1

Routing

Static · OSPF · EIGRP · RIP

Full IOS generation

Switching

VLANs, trunks, inter-VLAN routing (router-on-a-stick), STP, port-security

.1q subinterfaces + per-VLAN DHCP

Security

Device hardening (SSH, local users, enable-secret, banner), ACL/NAT

On live devices via the bridge

IPv6

Dual-stack addressing

Routers via CLI, hosts via SLAAC

Wireless

WiFi laptops + auto-associated Access Points

NIC swap → Wireless0, default-SSID assoc

Validation

Typed errors + auto-fixer

Wrong cables, missing ports, model upgrades

Verification

Plan-vs-live diff, health check, real ping (pt_verify_connectivity)

Drift, down links, duplicate IPs — and actual reachability

Deploy

Real-time bridge to PT (auto-reconciles)

No copy-paste — commands stream directly

Two channels

HTTP when the extension window is open, file-bridge when it's closed

PT keeps executing with the window minimized/closed

Projects

Save / open the real .pkt (pt_save_project / pt_open_project)

Persist the running topology, not just the plan JSON

Export

Plans, JS scripts, CLI configs

Reusable project files on disk

👉 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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers