localhost-mcp

로컬 개발 서버를 검사, 관리 및 종료하는 MCP 서버입니다. :3000에 무엇이 실행 중인지 추측할 필요가 없습니다.

👁 demo

terminal-history-mcp와 함께 사용하면 AI 에이전트가 실행한 작업과 현재 실행 중인 작업을 포함하여 개발 환경에 대한 완전한 메모리를 갖게 됩니다.

이유

모든 개발자가 매일 겪는 문제들:

• Error: listen EADDRINUSE :::3000 — 어떤 프로세스가 포트를 점유하고 있을까?

• 지난주부터 잊고 있던 5개의 node / vite / next PID가 RAM을 점유 중

• 프로젝트 전환 시 어떤 개발 서버가 여전히 실행 중인지 알 수 없음

• lsof -i :3000, kill -9 <pid> 반복

localhost-mcp는 이 모든 것을 하나의 도구 호출로 해결합니다.

Related MCP server: npm-dev-mcp

설치

npm install -g localhost-mcp

Claude Code에 연결:

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

또는 모든 MCP 호환 클라이언트에서 사용 가능합니다. 이 명령은 stdio MCP 서버로 실행됩니다.

도구

샘플 출력

{
 "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는 기본적으로 드라이런(dry-run)입니다. confirm=true를 전달해야 합니다.

• 1000 미만의 PID(시스템 프로세스)는 종료를 거부합니다.

• 개발 화이트리스트(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

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers

Tools

• find_zombiesA
• kill_serverA
• list_dev_serversA
• port_conflictA
• port_infoA