localhost-mcp

MCP-сервер для инспекции, управления и завершения локальных серверов разработки. Перестаньте гадать, что запущено на :3000.

👁 demo

Работает в паре с terminal-history-mcp — вместе они дают вашему ИИ-агенту полную память о вашей среде разработки: что вы запускали и что запущено сейчас.

Зачем

Каждый разработчик сталкивается с этим ежедневно:

• Error: listen EADDRINUSE :::3000 — что занимает порт?

• 5 забытых PID node / vite / next с прошлой недели, потребляющих оперативную память

• Переключение между проектами → нет понимания, какие серверы разработки все еще запущены

• lsof -i :3000, kill -9 <pid>, повторить

localhost-mcp позволяет сделать это одним вызовом инструмента.

Related MCP server: npm-dev-mcp

Установка

npm install -g localhost-mcp

Подключите к Claude Code:

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

Или к любому MCP-совместимому клиенту. Команда запускается как stdio MCP-сервер.

Инструменты

Пример вывода

{
 "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"
}

Безопасность

• kill_server по умолчанию работает в режиме предварительного просмотра. Необходимо передать confirm=true.

• Отказ от завершения PID < 1000 (системные процессы).

• Отказ от завершения процессов вне белого списка разработки (node, python, ruby, go, deno, bun, php, java, rails, vite, next и т.д.).

• Сначала отправляется SIGTERM, через 5 секунд ожидания — SIGKILL.

Обнаружение фреймворков

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.

При использовании общей командной строки (node server.js) выполняется поиск по package.json.

Поддержка платформ

• macOS — полная поддержка (использует lsof)

• Linux — полная поддержка (использует lsof + /proc)

• Windows — только базовое сканирование портов (использует netstat); определение рабочей директории / фреймворка ограничено

Использование CLI

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

Сборка из исходного кода

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

Лицензия

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• find_zombiesA
• kill_serverA
• list_dev_serversA
• port_conflictA
• port_infoA