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`).

「その他」の他のコンテンツ

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K

Glasswarp

See and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.

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