Pingo - Servidor MCP de depuración de LAN local

Un servidor MCP que expone un conjunto completo de herramientas para depurar tu red local, organizado mediante una arquitectura limpia de un servicio por responsabilidad, de modo que sea fácil de ampliar.

Herramientas expuestas

Related MCP server: netops-mcp

Notas de diseño

• Un servicio por responsabilidad (src/services/*): cada uno hace exactamente una tarea y es inyectado en el controlador, de modo que añadir un nuevo diagnóstico (p. ej., descubrimiento de MTU, prueba de ancho de banda) significa añadir un nuevo servicio + una llamada a registerTool, y nada más cambia.

• Sin superficie de inyección de shell. Todos los comandos del sistema operativo se ejecutan mediante execFile (una matriz argv, nunca una cadena de la shell), y cada entrada se valida contra una lista blanca estricta (src/utils/validators.ts) si antes de tocar un comando o socket.

• Delimitado por defecto. Los escaneos de puertos se limitan a un rango con 1024 puertos, los barridos a /24 y todo tiene un `‑timeout para procesos, así una entrada incorrecta no puede bloquear el proceso ni convertirse en un escaneo de red ilimitado.

• DNS usa el módulo nativo dns/promises de Node, no un comando de shell en absoluto; menos superficie de ejecución para la herramienta que parece más arriesgada.

Ejecución

pnpm install
pnpm dev        # tsx src/index.ts, hot-reload dev mode
pnpm build && pnpm start   # compiled prod run

El servidor escucha en http://localhost:3000/mcp.

Ampliación

1. Añade src/services/YourService.ts que implemente una interfaz IYourService (sigue el modelo de los servicios existentes: sin constructor, con un método centrado en el objetivo o dos).

2. Añádelo a PingoServices en PingoMcpController.ts y crea su instancia en src/index.ts.

3. Añade un bloque server.registerTool(...) dentro de registerTools().

Esa es toda la superficie de extensión: no hace falta tocar ningún otro archivo.