localhost-mcp

Servidor MCP que inspecciona, gestiona y finaliza servidores de desarrollo locales. Deja de adivinar qué hay en :3000.

👁 demo

Se combina con terminal-history-mcp: juntos le dan a tu agente de IA memoria completa de tu entorno de desarrollo: qué ejecutaste y qué se está ejecutando.

Por qué

Todo desarrollador se enfrenta a esto a diario:

• Error: listen EADDRINUSE :::3000 — ¿qué está ocupando el puerto?

• 5 PIDs de node / vite / next olvidados de la semana pasada consumiendo RAM

• Cambiar de proyecto → ni idea de qué servidores de desarrollo siguen ejecutándose

• lsof -i :3000, kill -9 <pid>, repetir

localhost-mcp lo convierte en una llamada de herramienta.

Related MCP server: npm-dev-mcp

Instalación

npm install -g localhost-mcp

Conéctalo a Claude Code:

claude mcp add --scope user localhost -- localhost-mcp

O a cualquier cliente compatible con MCP. El comando se ejecuta como un servidor MCP stdio.

Herramientas

Salida de muestra

{
 "port": 3000,
 "pid": 48211,
 "process": "node",
 "cmdline": "next dev",
 "cwd": "/Users/me/code/myapp",
 "project_name": "myapp",
 "framework": "next.js",
 "uptime_seconds": 14523,
 "memory_mb": 412,
 "cpu_pct": 0.3,
 "user": "me"
}

Seguridad

• kill_server utiliza ejecución en seco por defecto. Se debe pasar confirm=true.

• Se niega a finalizar PIDs < 1000 (procesos del sistema).

• Se niega a finalizar procesos fuera de la lista blanca de desarrollo (node, python, ruby, go, deno, bun, php, java, rails, vite, next, etc.).

• SIGTERM primero, escala a SIGKILL después de un tiempo de espera de 5s.

Frameworks detectados

next.js, vite, nuxt, remix, astro, webpack-dev-server, esbuild, create-react-app, express, fastify, koa, hono, rails, django, flask, fastapi, uvicorn, gunicorn, deno, bun, php-builtin, jekyll, hugo.

Recurre a la inspección de package.json cuando la línea de comandos es genérica (node server.js).

Soporte de plataforma

• macOS — soporte completo (usa lsof)

• Linux — soporte completo (usa lsof + /proc)

• Windows — solo escaneo básico de puertos (usa netstat); detección de cwd / framework limitada

Uso de CLI

localhost-mcp list # JSON list of all dev servers
localhost-mcp zombies # JSON list of zombie candidates
localhost-mcp # Start MCP stdio server

Construir desde el código fuente

git clone https://github.com/hasanjahidul/localhost-mcp.git
cd localhost-mcp
npm install
npm run build
node dist/cli.js list

Licencia

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• find_zombiesA
• kill_serverA
• list_dev_serversA
• port_conflictA
• port_infoA