localhost-mcp

用于检查、管理和终止本地开发服务器的 MCP 服务器。无需再猜测 :3000 上运行的是什么。

👁 demo

与 terminal-history-mcp 配合使用——它们共同为您的 AI 代理提供完整的开发环境记忆：您运行了什么，以及正在运行什么。

为什么使用它

每位开发者每天都会遇到这些问题：

• Error: listen EADDRINUSE :::3000 — 到底是什么占用了端口？

• 上周遗留的 5 个 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