Localhost Mcp

localhost-mcp

ローカルの開発サーバーを調査、管理、停止する MCP サーバーです。:3000 で何が動いているのか、もう推測する必要はありません。

terminal-history-mcp と組み合わせると、AI エージェントが開発環境の完全な記録を把握できます。実行したコマンドや、現在動作中のものが分かります。

理由

開発者なら、次のような状況によく遭遇します。

• Error: listen EADDRINUSE :::3000 — ポートを占有しているのは何でしょうか？
• 先週から忘れられた node / vite / next の PID が 5 つもあり、メモリを消費している
• プロジェクトを切り替えると、どの開発サーバーがまだ動いているのか分からない
• lsof -i :3000、kill -9 <pid> を繰り返す

localhost-mcp なら、ツール呼び出し 1 回で済みます。

インストール

npm install -g localhost-mcp

Claude Code に接続します。

claude mcp add --scope user localhost -- localhost-mcp

または、MCP 互換のクライアントならどれでも使用できます。このコマンドは stdio MCP サーバーとして実行されます。

ツール

ツール	用途
list_dev_servers	待ち受け中の開発サーバー一覧（ポート、PID、フレームワーク、プロジェクト、稼働時間、メモリ、CPU）
port_info	単一ポートを調査し、占有しているプロセスを確認します
kill_server	PID またはポートを指定して停止します。デフォルトではドライランです。実行するには confirm=true を渡します
find_zombies	長時間稼働中、アイドル状態、メモリ消費の大きい開発サーバーを検出します
port_conflict	ポート X が使用中の理由と、近くにある空きポートの候補 5 つを確認します

出力例

{
  "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 を使用）。cwd とフレームワークの検出には制限があります

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