Allows for the creation, configuration, validation, and explanation of network topologies in Cisco Packet Tracer, including generating CLI configurations and automated build scripts via the PTBuilder extension.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Packet Tracer MCPDesign a small office network with 2 routers, 5 PCs, and DHCP enabled."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Packet Tracer MCP v0.2
Servidor MCP (Model Context Protocol) que permite a un LLM crear, configurar, validar y explicar topologías de red en Cisco Packet Tracer.
Arquitectura V2
Usuario (lenguaje natural)
↓
LLM (Claude, GPT, etc.)
↓
MCP Server (14 tools, 5 resources)
↓
┌──────────────────────────────────────────┐
│ adapters/mcp/ ← tools + resources │
│ application/ ← use cases + DTOs │
│ domain/ ← modelos + servicios│
│ ├─ models/ ← requests, plans │
│ ├─ services/ ← orchestrator, etc. │
│ └─ rules/ ← validación │
│ infrastructure/ ← catálogo, generators│
│ ├─ catalog/ ← dispositivos, cables│
│ ├─ generator/ ← PTBuilder + CLI │
│ ├─ execution/ ← exportación │
│ └─ persistence/ ← proyectos │
│ shared/ ← enums, constants │
└──────────────────────────────────────────┘
↓
Packet Tracer (via PTBuilder extension)Tools MCP (14)
Tool | Descripción |
| Lista dispositivos disponibles con puertos |
| Lista plantillas de topología |
| Detalles de un modelo específico |
| Estimación dry-run (sin generar plan) |
| Genera plan completo desde parámetros |
| Valida un plan con errores tipificados |
| Auto-corrige errores del plan |
| Explica decisiones en lenguaje natural |
| Genera script PTBuilder (.js) |
| Genera configs CLI por dispositivo |
| Pipeline completo de una sola vez |
| Exporta a archivos |
| Lista proyectos guardados |
| Carga un proyecto guardado |
Resources MCP (5)
URI | Contenido |
| Catálogo de dispositivos |
| Tipos de cable |
| Alias de nombres |
| Plantillas con descripción |
| Capacidades del servidor |
Nuevas features V2
Error taxonomy: Errores tipificados con
ErrorCode, sugerencias de fixAuto-fixer: Corrige cables, upgradea routers, reasigna puertos
Explainer: Genera explicaciones humanas de cada decisión
Estimator: Dry-run — muestra qué se creará sin generar
Templates formales: 9 plantillas con metadata (tags, rangos, defaults)
Persistencia: Guardar/cargar proyectos
30 tests: Unit + integración
Instalación
cd PACKET-TRACER
pip install -e .Uso
Como servidor MCP (stdio)
python -m src.packet_tracer_mcpVS Code (.vscode/mcp.json)
{
"servers": {
"packet-tracer": {
"command": "python",
"args": ["-m", "src.packet_tracer_mcp"],
"cwd": "D:\\MCP\\PACKET-TRACER"
}
}
}Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"packet-tracer": {
"command": "python",
"args": ["-m", "src.packet_tracer_mcp"],
"cwd": "D:\\MCP\\PACKET-TRACER"
}
}
}Ejemplo de uso
→ pt_estimate_plan(routers=3, pcs_per_lan=4, has_wan=true)
→ pt_full_build(routers=3, pcs_per_lan=4, has_wan=true, dhcp=true)
→ pt_explain_plan(plan_json)
→ pt_fix_plan(plan_json)
→ pt_export(plan_json, project_name="mi_red")Tests
python -m pytest tests/ -vPara usar con PTBuilder
Instala PTBuilder en Packet Tracer (Builder Code Editor)
Genera el script con
pt_generate_scriptopt_full_buildCopia el script JS en PTBuilder y ejecútalo
Aplica las configs CLI en cada dispositivo