Servidor MCP para controlar Cisco Packet Tracer con Gemini CLI y Copilot CLI usando tools en lenguaje natural.
BETA: Este proyecto está en fase beta. Puede cambiar sin previo aviso y algunas funciones pueden ser inestables según la versión de Cisco Packet Tracer.
Para que el servidor MCP se comunique correctamente, asegúrate de tener todo esto listo antes de iniciar:
- Sistema Operativo: Windows o Linux.
- Node.js: Versión 18 o superior instalada.
- Cisco Packet Tracer: Instalado y cerrado (el launcher lo abrirá por ti).
- Extensión BridgeBuilder (Crucial): Packet Tracer necesita tu script module persistente para permitir inyección de scripts. Si no lo tienes cargado aún, instálalo con:
.\scripts\install-bridgebuilder.ps1- CLI de IA (Gemini o Copilot): Puedes usar cualquiera de los dos.
- Gemini CLI: npm install -g @google/gemini-cli - Copilot CLI: npm install -g @githubnext/github-copilot-cli
Instaladores Automáticos (Windows y Linux)
Ahora tienes una carpeta dedicada con instaladores de prerrequisitos:
- Windows: installer/install-prereqs.bat
- Linux: installer/install-prereqs.sh
Estos instaladores te van guiando paso a paso y te preguntan si quieres instalar:
- Node.js y npm
- Gemini CLI
- Copilot CLI
Tambien verifican si ya lo tienes instalado y, si algo falla, intentan otros metodos.
Recomendaciones rapidas
- En Windows, si un metodo falla por permisos, ejecuta el
.batcomo administrador. - En Linux, si al terminar no reconoce
geminiocopilot, abre una terminal nueva o ejecutasource ~/.bashrc. - Si el instalador de Linux te pregunta por PATH, responde que si para evitar problemas despues.
Uso recomendado
Windows:
installer\install-prereqs.batLinux:
chmod +x installer/install-prereqs.sh
./installer/install-prereqs.shnpm install
npm run build.\run.cmdEl launcher:
- Muestra
.pktde Descargas para elegir. - Permite crear un
.pktnuevo. - Arranca MCP server automaticamente.
- Te deja elegir y abre Gemini CLI o Copilot CLI.
Activación MANUAL del Bridge en Packet Tracer
Aunque el launcher abre todo automáticamente, el puente de comunicación requiere que actives la interfaz de tu extensión:
- Ve al menú superior y selecciona
Extensions->Scripting->Edit File Script Module->BridgeBuilder. - Abre la interfaz
Conectary pulsaCorrer(botón verde). - Deja la ventanita abierta o minimizada mientras trabajas para mantener conexión persistente.
| Tool | Descripcion |
|---|---|
packet_tracer_build_basic_topology | Construye topologia basica completa |
packet_tracer_add_device | Agrega dispositivo a la topologia |
packet_tracer_add_link | Crea enlace entre dispositivos |
packet_tracer_configure_device | Configura un dispositivo (CLI commands) |
packet_tracer_configure_pc_ip | Configura IP de un PC |
pt_full_build | Build completo de topologia |
pt_bridge_status | Estado del bridge en tiempo real |
pt_bridge_autoconnect | Auto-conexion bridge con BridgeBuilder |
pt_send_raw | Envia codigo JS raw al bridge |
pt_export_bridge_extension | Exporta extension del bridge |
| Endpoint | URL |
|---|---|
| Monitor visual | http://127.0.0.1:54321/monitor |
| Estado JSON | http://127.0.0.1:54321/status |
- Mantén abierto BridgeBuilder (puede estar minimizado).
- Si algo no ejecuta, corre
pt_bridge_autoconnecty luegopt_bridge_status.
Autoría y créditos
- Certificado de autoria: CERTIFICADO-DE-AUTORIA.md
- Licencia de uso y creditos obligatorios: LICENSE.md
- Aviso legal de distribucion: NOTICE.md