Localhost MCP Server

Q: What platforms does Localhost Mcp support?

macOS and Linux have full support (using `lsof` and `/proc`). Windows support is basic (port scan only via `netstat`; cwd and framework detection are limited).

Q: Is it safe to kill servers with Localhost Mcp?

Yes. The `kill_server` tool defaults to dry‑run; you must pass `confirm=true` to execute. It refuses to kill PIDs < 1000 (system processes) and only targets whitelisted executables (node, python, ruby, go, deno, bun, etc.). It sends SIGTERM first and escalates to SIGKILL after a 5‑second timeout.

Q: How do I install and configure Localhost Mcp?

Install globally via npm: `npm install -g localhost-mcp`. Then add it to your MCP client (e.g., for Claude Code: `claude mcp add --scope user localhost -- localhost-mcp`). The server runs as a stdio MCP process.

Q: Which frameworks does Localhost Mcp detect?

It detects 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, and hugo. It falls back to `package.json` sniffing when the command line is generic (e.g., `node server.js`).

@HasanJahidul

代码仓库

基本信息

分类

其他

许可证

MIT

传输方式

stdio

作者

HasanJahidul

提交者

Jahidul Hasan

关于 Localhost MCP Server

MCP server: inspect, manage, kill local dev servers. Stop guessing what's on :3000.

#localhost#dev-server#ports #process#lsof#kill#zombie#nodejs #typescript #claude

Localhost MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "localhost": {
      "command": "npx",
      "args": [
        "-y",
        "localhost-mcp"
      ]
    }
  }
}

Localhost MCP Server 工具

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 `confirm=true` to execute

Detect long-running, idle, memory-heavy dev servers

Why is port X busy + 5 free alternatives nearby

概览

What is Localhost Mcp?

Localhost Mcp is an MCP server that inspects, manages, and kills local development servers. It resolves port conflicts, finds zombie processes, and provides detailed information about running dev servers, making it a companion for any AI agent that manages a local development environment.

How to use Localhost Mcp?

Install globally with npm install -g localhost-mcp, then wire into Claude Code with claude mcp add --scope user localhost -- localhost-mcp or any MCP-compatible client. The server operates as a stdio MCP server. CLI usage includes localhost-mcp list (list dev servers), localhost-mcp zombies (find zombie candidates), and plain localhost-mcp to start the stdio server.

Key features of Localhost Mcp

Lists all listening dev servers with port, PID, framework, project, uptime, memory, CPU
Inspects a single port to identify the holding process
Kills servers by PID or port, with dry‑run mode by default
Detects zombie dev servers (long‑running, idle, memory‑heavy)
Identifies port conflicts and suggests five free nearby ports
Refuses to kill system processes (PIDs < 1000) and non‑whitelisted executables

Use cases of Localhost Mcp

Quickly identify what is holding a port (e.g., EADDRINUSE on :3000)
Clean up forgotten node/vite/next processes consuming RAM between projects
Programmatically free a port for a new dev server via AI agent
Monitor dev server health across projects during long development sessions

常见问题

What platforms does Localhost Mcp support?

macOS and Linux have full support (using `lsof` and `/proc`). Windows support is basic (port scan only via `netstat`; cwd and framework detection are limited).

Is it safe to kill servers with Localhost Mcp?

Yes. The `kill_server` tool defaults to dry‑run; you must pass `confirm=true` to execute. It refuses to kill PIDs < 1000 (system processes) and only targets whitelisted executables (node, python, ruby, go, deno, bun, etc.). It sends SIGTERM first and escalates to SIGKILL after a 5‑second timeout.

How do I install and configure Localhost Mcp?

Install globally via npm: `npm install -g localhost-mcp`. Then add it to your MCP client (e.g., for Claude Code: `claude mcp add --scope user localhost -- localhost-mcp`). The server runs as a stdio MCP process.

Which frameworks does Localhost Mcp detect?

It detects 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, and hugo. It falls back to `package.json` sniffing when the command line is generic (e.g., `node server.js`).

其他分类下的更多 MCP 服务器

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K