Packet Tracer MCP Server

Packet Tracer MCP Server

Servidor MCP que permite a cualquier LLM (Copilot, Claude, etc.) crear, configurar, validar y desplegar topologías de red completas en Cisco Packet Tracer.

Le decís "creame una red con 3 routers, DHCP y OSPF" y el servidor planifica la topología, valida todo, genera los scripts y configs, y lo despliega directo en PT en tiempo real.

Python 3.11+ · Pydantic 2.0+ · FastMCP · Streamable HTTP

Instalación

git clone <repo>
cd PACKET-TRACER
pip install -e .

Uso

1. Levantar el servidor

python -m src.packet_tracer_mcp

Esto inicia:

• Servidor MCP en http://127.0.0.1:39000/mcp (streamable-http)
• Bridge HTTP en http://127.0.0.1:54321 (comunicación con Packet Tracer)

Ambos arrancan automáticamente. No se necesita ningún script adicional.

Para modo stdio (debug/legacy): python -m src.packet_tracer_mcp --stdio

2. Configurar el cliente MCP

VS Code — .vscode/mcp.json:

{
  "servers": {
    "packet-tracer": {
      "url": "http://127.0.0.1:39000/mcp"
    }
  }
}

Claude Desktop — claude_desktop_config.json:

{
  "mcpServers": {
    "packet-tracer": {
      "url": "http://127.0.0.1:39000/mcp"
    }
  }
}

3. Usar desde el LLM

Pedile al LLM que cree una red. El servidor expone 22 tools MCP que cubren todo el pipeline:

¿Por qué el servidor corre en el puerto 39000?

El servidor MCP usa streamable-http en lugar de stdio. Esto significa que el servidor se levanta una vez como un proceso HTTP persistente y los clientes MCP se conectan a él por red.

Ventajas sobre stdio:

• Persistencia — el servidor queda corriendo, no se reinicia con cada sesión del editor
• Múltiples clientes — podés conectar VS Code, Claude Desktop u otros clientes al mismo servidor simultáneamente
• Estado compartido — el bridge HTTP hacia Packet Tracer se mantiene activo entre requests
• Debug más fácil — podés hacer curl al servidor, ver logs en la terminal donde corre
• Desacoplamiento — el servidor no depende del ciclo de vida del editor

El puerto 39000 fue elegido para no colisionar con puertos comunes (3000, 5000, 8000, 8080) ni con el bridge interno de PT que usa el 54321.

Live Deploy — Despliegue en tiempo real

La feature principal: enviar comandos directamente a Packet Tracer sin copiar/pegar nada.

┌─────────┐         ┌──────────────┐   HTTP    ┌──────────────┐  $se()  ┌──────────────┐
│   LLM   │  MCP    │  MCP Server  │  :54321   │  PTBuilder   │  IPC   │ Packet Tracer│
│(Copilot)│ ──────► │  (:39000)    │ ────────► │  (WebView)   │ ─────► │   (Engine)   │
└─────────┘         └──────────────┘           └──────────────┘        └──────────────┘

Hay dos servidores HTTP corriendo:

Setup del bridge (una vez por sesión de PT):

1. Abrí Packet Tracer 8.2+
2. Abrí Builder Code Editor (Extensions > Builder Code Editor)
3. Pegá este bootstrap y hacé clic en Run:

/* PT-MCP Bridge */ window.webview.evaluateJavaScriptAsync("setInterval(function(){var x=new XMLHttpRequest();x.open('GET','http://127.0.0.1:54321/next',true);x.onload=function(){if(x.status===200&&x.responseText){$se('runCode',x.responseText)}};x.onerror=function(){};x.send()},500)");

Eso hace que PTBuilder haga polling cada 500ms al bridge. Cu