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 RAM - Switching 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 |
|---|---|
list_dev_servers |
All listening dev servers w/ port, pid, framework, project, uptime, mem, cpu |
port_info |
Inspect single port — who holds it |
kill_server |
Kill by pid or port. Dry-run by default; pass confirm=true to execute |
find_zombies |
Detect long-running, idle, memory-heavy dev servers |
port_conflict |
Why is port X busy + 5 free alternatives nearby |
