Power your agent
การติดตั้งจากผู้เผยแพร่ ไม่ใช่เอนด์พอยต์ของ PlugMCP
URL แบบรีโมตหรือคำสั่งบนเครื่องของคุณ? การติดตั้งสองแบบต่างกันอย่างไร
รันบน PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
เปิดจากผู้เผยแพร่
Español | English
Plataforma full-stack de automatización y gestión de redes que unifica (Cisco Packet Tracer y GNS3), (SSH, Telnet y consola serial) y para configurar, diagnosticar y documentar infraestructura de red en lenguaje natural.
AI-powered agentic platform and Model Context Protocol (MCP) server for hybrid network automation and management. Unifies Cisco Packet Tracer, GNS3, SSH, Telnet, and physical hardware with multi-agent orchestration, terminal, web search, and RAG.
Es un monorepo TypeScript con un backend Express que orquesta agentes con Deep Agents, un frontend Next.js con dashboard, terminal web y workspace de topologías, una extensión nativa que conecta Cisco Packet Tracer con el agente y un servidor MCP que expone el motor de red a cualquier agente de código (Claude Code, Codex CLI, OpenCode, Cursor, VS Code, LM Studio…).
También se distribuye como aplicación de escritorio con instalador propio: empaqueta backend, frontend y base de datos en un solo programa, sin requerir Node.js ni Docker en el equipo destino. Disponible para Windows (instalador NSIS) y Linux (AppImage / .deb); ver Instalador para Windows.
@packet-tools-ai/root · @packet-tools-ai/app · @packet-tools-ai/mcpLa forma más rápida de usar Packet Tools, sin clonar el repositorio ni configurar nada:
npx -y --package=@packet-tools-ai/root packet-tools-ai
Para tenerlo siempre a mano sin pasar por npx:
npm i -g @packet-tools-ai/root # instala los binarios packet-tools-ai y packet-tools
packet-tools-ai # abre el menú
El comando pide primero el idioma (Español / English), lo recuerda en ~/.packet-tools/preferences.json (por defecto, español) y después abre un menú con tres opciones. El menú se maneja con las flechas (↑ / ↓), se elige con Enter y se cancela con Ctrl+C; la opción múltiple del MCP se marca con Espacio (aparece una x), A marca todas y Enter confirma:
Opciones del instalador:
--web, --mcp, --desktop: ejecutan directamente el flujo correspondiente, sin pasar por el menú.--mcp-server: arranca el servidor MCP por stdio (bin packet-tools-mcp).--lang es|en: fuerza el idioma solo en esa ejecución.--no-color: desactiva los colores de esa ejecución (también NO_COLOR=1).--help / --version: muestran la ayuda o la versión.PACKET_TOOLS_LANG=es|en: variable de entorno equivalente a --lang.PACKET_TOOLS_NO_TUI=1: fuerza el modo de texto (números + Enter) aunque haya terminal.Si solo quieres una de las dos piezas, sin menú:
npx -y --package=@packet-tools-ai/app packet-tools-ai-app # solo la app web
npx -y @packet-tools-ai/mcp # solo el servidor MCP
Hay cuatro formas de instalar Packet Tools. Elige la que corresponda a lo que necesitas:
node -v y npm -v.7531 (API) y 3090 (web) libres. Si están ocupados puedes cambiarlos: SERVER_PORT y PORT en la app web, o el .env en el código fuente.Es la vía más rápida: un solo comando abre un menú y se encarga de todo. No hace falta clonar el repositorio.
Paso 1 — Abre una terminal (PowerShell, CMD, Terminal de macOS o la shell de Linux).
Paso 2 — Ejecuta el instalador:
npx -y --package=@packet-tools-ai/root packet-tools-ai
El
--package=es necesario: el paquete expone tres binarios (packet-tools-ai,packet-toolsypacket-tools-mcp), así que hay que decirle anpxcuál usar.
Paso 3 — Selecciona el idioma (Español / English). Se guarda en ~/.packet-tools/preferences.json y se recuerda en la próxima ejecución.
Paso 4 — Elige una opción del menú:
Usa ↑ / ↓ para mover el cursor y Enter para confirmar. En la lista de agentes del MCP, Espacio marca cada uno con una x, A marca todos y Enter confirma la selección.
Si prefieres saltarte el menú, usa los atajos: --web, --mcp, --desktop, --mcp-server, --lang es|en, --no-color, --help y --version.
Paso 5 — Inicia sesión con admin / admin123 y ve a Configuración para añadir tu proveedor de IA. Cambia la contraseña si vas a usarlo fuera de tu equipo.
Si solo quieres la aplicación web, ejecútala sin pasar por el menú:
npx -y --package=@packet-tools-ai/app packet-tools-ai-app
Al arrancar:
uploads/, logs/ y el secreto JWT) en ~/.packet-tools/app;http://localhost:7531 y abre http://localhost:3090.Variables útiles:
Abre siempre la interfaz con
localhost, nunca con127.0.0.1: el backend compila la URL y las cookies están atadas a ese host.
El servidor MCP expone el motor de Packet Tools (Packet Tracer, GNS3, serial, Telnet y SSH) a agentes como Claude, Cursor, OpenCode, VS Code o Codex CLI. Es un paquete ligero e independiente:
npx -y @packet-tools-ai/mcp
Lo normal es invocarlo desde la configuración de tu agente. El instalador (packet-tools-ai --mcp) ya escribe la entrada por ti en los 8 clientes soportados; si prefieres hacerlo a mano, la entrada es:
{
"mcpServers": {
"packet-tools": {
"command": "npx",
"args": ["-y", "--package=@packet-tools-ai/mcp", "packet-tools-mcp"]
}
}
}
Detalle por cliente (Claude Code, Cursor, Windsurf, LM Studio, OpenCode, VS Code, Codex CLI, DeepSeek) y transporte HTTP en packages/mcp/README.md.
npm run init, migraciones y npm run dev.docker compose up --build; ver Docker.packet-tools-ai --version # 1.3.0
curl http://localhost:7531/api/health # {"success":true,...}
http://localhost:3090 debe mostrar la pantalla de acceso.npx -y @packet-tools-ai/mcp debe imprimir MCP server ready (stdio): 95 tools from 7 domains.Packet Tools nace de una idea simple: un solo lugar para administrar la red, con ayuda de agentes. Desde el dashboard puedes abrir una consola SSH a un switch real, pedirle al agente que revise y configure la red, levantar una topología en Packet Tracer o GNS3, guardar la topología resultante, programar tareas recurrentes y dejar registro de todo lo que ocurre.
El agente no es un chatbot que solo responde texto: es un controlador de consola y simulador con herramientas reales. Se conecta a los dispositivos mediante los mismos protocolos que usaría un ingeniero, clasifica el riesgo de cada comando y, cuando una acción es sensible, pide aprobación humana antes de ejecutarla (Human-in-the-Loop).
@dispositivo o el selector del chat), la petición va directo al agente del protocolo correspondiente; si no, el supervisor decide.STAFF y ADMIN: ejecuta acciones sin confirmaciones (los comandos destructivos siguen protegidos).baseUrl, API key enmascarada, activación individual y permisos por rol (userPermission).ADMIN.ssh2), Telnet y puerto serial (RS-232 / USB-Serial) con baudrate configurable.GET /api/terminal/sessions) y modo solo lectura para el rol USER.reload, write erase, erase, format, delete, boot system) requieren aprobación explícita y nunca se ejecutan sin canal interactivo.exit, quit, logout) y los lotes de cierre se bloquean por completo..pdf, .txt y .md (hasta 25 MB) desde la web, indexados con embeddings del proveedor activo.@rag y herramienta search_knowledge_base disponible para todos los agentes.getNetwork) para reflejar la topología real del simulador.STANDARD (ejecuta los comandos del payload sobre el dispositivo) e INTELLIGENT (el agente ejecuta la tarea sobre la topología o el dispositivo asociado) con expresión cron validada y previsualización.CRITICAL, HIGH, MEDIUM, LOW) ligadas a topologías.ADMIN.USER < STAFF < ADMIN aplicados en cada ruta de la API y en los sockets.zod, CORS con credenciales y enmascarado automático de secretos (password, token, apiKey) en las respuestas.Expone el motor de Packet Tools (Packet Tracer, GNS3, serial, Telnet y SSH) como herramientas MCP que cualquier agente de código puede invocar: Claude Code, Codex CLI, OpenCode, VS Code (GitHub Copilot), LM Studio, Cursor, Windsurf, DeepSeek y cualquier cliente MCP estándar.
Se ejecuta directo desde npm (y también desde GitHub), sin clonar ni compilar:
{
"mcp": {
"packet-tools": {
"type": "local",
"command": [
"npx",
"-y",
"--package=@packet-tools-ai/mcp",
"packet-tools-mcp"
],
"enabled": true
}
}
}
El instalador (npx -y --package=@packet-tools-ai/root packet-tools-ai, opción MCP) lo configura automáticamente en 8 clientes: Claude Desktop, Claude Code, Cursor, Windsurf, LM Studio, OpenCode, VS Code y Codex CLI.
95 herramientas en 7 dominios (packet_tracer_*, gns3_*, serial_*, telnet_*, ssh_*, plan_*, skills_*) sobre transporte stdio.
La integración con Packet Tracer requiere la extensión v1.1.0 o superior; el resto de dominios funciona sin ella. Detalle y configuración por cliente en packages/mcp/README.md.
Además del stdio, expone transporte HTTP remoto (/mcp Streamable HTTP y /sse legacy), pensado para clientes web como Gemini Apps (URL pública HTTPS vía túnel); detalle en packages/mcp/README.md.
packet-tools-ai/
├── packages/
│ ├── server/ # Backend: API, agentes, sockets, Prisma (ver packages/server/README.md)
│ ├── web/ # Frontend: dashboard, chat, terminal, workspace (ver packages/web/README.md)
│ ├── app/ # Paquete npm de la app web: backend + frontend sin Electron (ver packages/app/README.md)
│ ├── desktop/ # Instalador de escritorio Electron (NSIS, AppImage, deb; ver packages/desktop/README.md)
│ └── mcp/ # Servidor MCP (Model Context Protocol; ver packages/mcp/README.md)
├── extension-packetracer/ # Extensión nativa de Cisco Packet Tracer (JavaScript, cliente Socket.IO)
├── bin/ # CLI del instalador (menú Web/MCP/Desktop, i18n ES/EN)
├── scripts/ # Verificación del instalador y configuración de MCP
├── dockerfile # Imagen todo-en-uno (backend + frontend)
├── docker-compose.yml # Despliegue con un comando y volumen para SQLite
├── docker-entrypoint.sh # Migraciones + seed + arranque de servicios
├── .example.env # Plantilla de variables de entorno
├── turbo.json # Pipeline de Turborepo
└── package.json # Scripts raíz y workspaces
.env en la raíz (se genera con npm run init a partir de .example.env).http://localhost:3080) para los laboratorios virtuales.¿Solo quieres usarlo en tu PC? Salta directamente al instalador para Windows; no necesitas Node.js ni Docker.
git clone https://github.com/ph0Void/packet-tools-ai.git
cd packet-tools-ai
npm run init # copia .example.env a .env e instala las dependencias
npm run initusacp; funciona en Linux, macOS, Git Bash y PowerShell (alias deCopy-Item).
npm run migrate # crea la base SQLite y aplica las migraciones
npm run generate # genera el cliente de Prisma
npm run seed # carga datos iniciales (usuario admin, dispositivos y modelos de ejemplo)
npm run dev # backend + frontend en paralelo (Turborepo)
Los puertos se definen en el .env raíz (PORT y SERVER_PORT).
Advertencia: cambia la contraseña de
adminy define unJWT_SECRETpropio antes de exponer el servicio fuera de tu equipo. La clave incluida en.example.enves solo de ejemplo.
admin./dashboard/configuration).baseUrl (para Ollama/LM Studio/custom) y la API key cuando corresponda.userPermission para decidir qué roles pueden usarlo.EMBEDDING.extension-packetracer/ dentro del directorio extensions de tu instalación de Cisco Packet Tracer y reinicia el programa.Packet Tools incluye un instalador de escritorio (Electron + electron-builder) que empaqueta el backend, el frontend y la base de datos SQLite en una sola aplicación. No requiere Node.js, Docker ni dependencias adicionales en el equipo donde se instala: la aplicación trae su propio runtime de Node y arranca todo automáticamente.
Packet Tools Setup <versión>.exe desde la sección Releases.admin / admin123.Para generar el instalador desde el código fuente:
npm run build-desktop -- --win # instalador NSIS (.exe) — se compila en Windows
npm run build-desktop -- --linux # AppImage / .deb — se compila en Linux
Los artefactos quedan en packages/desktop/dist/. El proceso descarga Electron, el runtime de Node y las herramientas de empaquetado (requiere conexión a internet) y no necesita Visual Studio Build Tools. Detalles técnicos del empaquetado en packages/desktop/AGENTS.md.
El repositorio incluye una imagen todo-en-uno que ejecuta backend y frontend en el mismo contenedor (es la configuración más simple, porque NEXT_PUBLIC_API_URL apunta a http://localhost:7531, válido tanto desde tu navegador como dentro del contenedor).
cp .example.env .env # si aún no existe
docker compose up --build
Notas:
admin / admin123. Cámbialo después del primer acceso.packages/server/prisma/migrations/): se generan en local con npm run migrate a partir de schema.prisma. Ejecuta npm run migrate al menos una vez antes de construir la imagen, o el migrate:deploy del entrypoint no tendrá nada que aplicar y el seed fallará..env raíz se pasan al contenedor (env_file); NEXT_PUBLIC_API_URL también se usa como argumento de build, así que si despliegas en un servidor remoto edítalo antes de construir (por ejemplo NEXT_PUBLIC_API_URL=http://mi-servidor:7531).devices en docker-compose.yml (/dev/ttyUSB0:/dev/ttyUSB0).docker build -f dockerfile --build-arg NEXT_PUBLIC_API_URL=http://localhost:7531 -t packet-tools .
docker run -p 7531:7531 -p 3090:3090 -v packet-tools-data:/app/data --env-file .env packet-tools
Todas viven en el .env de la raíz del monorepo. Plantilla: .example.env.
El
.env, la base de datos SQLite (packages/server/.packet_tool_database.db), los archivos subidos (packages/server/uploads/) y los logs están gitignoreados y nunca se publican en el repositorio. Ver Qué no se publica.
Las variables AGENT_* (límites de contexto, tokens, reintentos y timeouts) y las MCP_* (transporte HTTP remoto) son opcionales y están documentadas —comentadas— en .example.env.
Desde la raíz del monorepo:
Pruebas:
npm test # toda la suite
npm test -- test/auth.test.ts # una suite concreta
npm test -- --watch # modo watch
Verificación mínima antes de enviar cambios: npm run lint + npm run build; si tocaste el backend, además npm test. El frontend no tiene script de tipos ni de tests: se valida con npx tsc --noEmit y sus comprobaciones ejecutables en packages/web/scripts/ (ver packages/web/AGENTS.md).
Este repositorio es público y no incluye datos de ejecución. Quedan fuera por .gitignore:
.env y cualquier .env.* (solo se versiona .example.env, con valores de ejemplo).packages/server/.packet_tool_database.db, packages/mcp/.packet_tools_mcp.db y cualquier *.db / *.sqlite.packages/server/uploads/) y logs.packages/server/prisma/migrations/): se crean en local con npm run migrate desde schema.prisma.dist/, .next/, .turbo/, packages/app/runtime/ y el instalador (packages/desktop/dist/, .staging/, .cache/).PRIVATE.md, BACKLOG.md, RESUME.md) y configuración local de agentes.Las claves de API nunca se guardan en el código: cada usuario configura las suyas desde la interfaz y se almacenan en su propia base de datos local, enmascaradas al leerlas por la API.
ConfigTemplate ya está en la base de datos; falta el CRUD, la UI y la ejecución de plantillas con variables (hostname, ip, etc.) desde el chat y las tareas programadas.Las contribuciones son bienvenidas. Si encuentras un error o quieres proponer una mejora, abre un issue o envía un pull request describiendo el cambio.
MIT. Consulta LICENSE.md para más detalle.
El objetivo de este proyecto es brindar una herramienta libre, transparente y fácil de usar, apoyándonos en diversos agentes de inteligencia artificial que permitan a los usuarios crear, usar y administrar sus propias redes de manera automatizada, ya sea en simuladores o en equipos reales, de forma independiente de las marcas.
Asimismo, les recordamos que Packet Tools es propenso a errores, por lo que estamos realizando actualizaciones constantes para ofrecer una mejor experiencia y asegurar que esta herramienta realmente les sea de utilidad a todos ustedes.
Además, Packet Tools es un proyecto libre y de código abierto; pueden descargarlo, usarlo y modificarlo a su gusto y, si gustan, compartirlo.
¡Éxitos! Hasta una futura actualización.
Atte. ph0Void
AI-powered agentic platform and Model Context Protocol (MCP) server for hybrid network automation and management. Unifies Cisco Packet Tracer, GNS3, SSH, Telnet, and physical hardware with multi-agent
ภาพรวม
AI-powered agentic platform and Model Context Protocol (MCP) server for hybrid network automation and management. Unifies Cisco Packet Tracer, GNS3, SSH, Telnet, and physical hardware with multi-agent orchestration, terminal, web search, and RAG.
เครื่องมือ
ยังไม่มีรายการเครื่องมือ เซิร์ฟเวอร์แบบรีโมตจะได้รายการหลังการตรวจสอบสถานะครั้งแรก
FAQ
คัดลอกคอนฟิก stdio สำหรับ Cursor, Claude Desktop, Claude Code หรือ VS Code ได้ในหน้านี้ คอนฟิกนี้ใช้การติดตั้งของผู้เผยแพร่ ไม่ใช่พร็อกซีของ PlugMCP
ระเบียนนี้ไม่ได้ระบุตัวแปรสภาพแวดล้อมที่จำเป็น
Packet Tools Ai ทำงานแบบโลคัลผ่าน stdio
ตรวจสอบล่าสุดเมื่อ 2026-10-28 AI-powered agentic platform and Model Context Protocol (MCP) server for hybrid network automation and management. Unifies Cisco Packet Tracer, GNS3, SSH, Telnet, and physical hardware with multi-agent orchestration, terminal, web search, and RAG.
