localhost-mcp
Detects and provides information about Astro dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Bun dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Deno dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Django dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about esbuild dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Express dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about FastAPI dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Fastify dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Flask dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Gunicorn dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Hono dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Hugo dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Jekyll dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Koa dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Next.js dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Nuxt dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about PHP dev servers (e.g., php-builtin), including port, PID, memory usage, and allows killing them.
Detects and provides information about Python dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about React dev servers (e.g., create-react-app), including port, PID, memory usage, and allows killing them.
Detects and provides information about Remix dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Ruby dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about Vite dev servers, including port, PID, memory usage, and allows killing them.
Detects and provides information about webpack-dev-server instances, including port, PID, memory usage, and allows killing them.
localhost-mcp
MCP server that inspects, manages, and kills local dev servers. Stop guessing what's on :3000.
Pairs with terminal-history-mcp — together they give your AI agent full memory of your dev environment: what you ran, what's running.
Why
Every dev hits these daily:
Error: listen EADDRINUSE :::3000— what's holding the port?5 forgotten
node/vite/nextPIDs from last week eating RAMSwitching projects → no idea which dev servers still running
lsof -i :3000,kill -9 <pid>, repeat
localhost-mcp makes it one tool call.
Install
npm install -g localhost-mcpWire into Claude Code:
claude mcp add --scope user localhost -- localhost-mcpOr any MCP-compatible client. The command runs as a stdio MCP server.
Tools
Tool | Purpose |
| All listening dev servers w/ port, pid, framework, project, uptime, mem, cpu |
| Inspect single port — who holds it |
| Kill by pid or port. Dry-run by default; pass |
| Detect long-running, idle, memory-heavy dev servers |
| Why is port X busy + 5 free alternatives nearby |
Sample output
{
"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"
}Safety
kill_serverdefaults to dry-run. Must passconfirm=true.Refuses to kill PIDs < 1000 (system processes).
Refuses processes outside the dev whitelist (node, python, ruby, go, deno, bun, php, java, rails, vite, next, etc).
SIGTERM first, escalates to SIGKILL after 5s timeout.
Frameworks detected
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.
Falls back to package.json sniffing when the cmdline is generic (node server.js).
Platform support
macOS — full support (uses
lsof)Linux — full support (uses
lsof+/proc)Windows — basic port scan only (uses
netstat); cwd / framework detection limited
CLI usage
localhost-mcp list # JSON list of all dev servers
localhost-mcp zombies # JSON list of zombie candidates
localhost-mcp # Start MCP stdio serverBuild from source
git clone https://github.com/hasanjahidul/localhost-mcp.git
cd localhost-mcp
npm install
npm run build
node dist/cli.js listLicense
MIT
Maintenance
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/HasanJahidul/localhost-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server