AI导哈

MCP数据包追踪服务器

一个通过自然语言工具控制Cisco Packet Tracer的服务器，支持Gemini CLI和Copilot CLI。

  • by y0konad
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 Yokonad/mcp-gemini-packet

使用说明

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:

  1. Sistema Operativo: Windows o Linux.
  2. Node.js: Versión 18 o superior instalada.
  3. Cisco Packet Tracer: Instalado y cerrado (el launcher lo abrirá por ti).
  4. 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
  5. 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:

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 .bat como administrador.
  • En Linux, si al terminar no reconoce gemini o copilot, abre una terminal nueva o ejecuta source ~/.bashrc.
  • Si el instalador de Linux te pregunta por PATH, responde que si para evitar problemas despues.

Uso recomendado

Windows:

installer\install-prereqs.bat

Linux:

chmod +x installer/install-prereqs.sh
./installer/install-prereqs.sh

npm install
npm run build

.\run.cmd

El launcher:

  1. Muestra .pkt de Descargas para elegir.
  2. Permite crear un .pkt nuevo.
  3. Arranca MCP server automaticamente.
  4. 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:

  1. Ve al menú superior y selecciona Extensions -> Scripting -> Edit File Script Module -> BridgeBuilder.
  2. Abre la interfaz Conectar y pulsa Correr (botón verde).
  3. 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_autoconnect y luego pt_bridge_status.

Autoría y créditos

相关 MCP