local-server-hub
Recognizes local Angular dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Angular default or next free ports.
Recognizes local Astro dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Astro default or next free ports.
Recognizes local Django dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Django default or next free ports.
Detects Docker container port mappings for local services, lists them alongside other listeners, and returns a warning if the Docker CLI is unavailable.
Recognizes local FastAPI dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest FastAPI default or next free ports.
Recognizes local Flask dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Flask default or next free ports.
Recognizes local .NET dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest .NET default or next free ports.
Recognizes local Node.js dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest default or next free ports.
Recognizes local Nuxt dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Nuxt default or next free ports.
Recognizes local PHP dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest default or next free ports.
Recognizes local Remix dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Remix default or next free ports.
Recognizes local Rust dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest default or next free ports.
Recognizes local Spring dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Spring default or next free ports.
Recognizes local Vite dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest Vite default or next free ports.
Recognizes local webpack dev servers, reporting listening port, process, project directory, stack, URL, and HTTP status, and helps suggest webpack default or next free ports.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
local-server-hub
MCP server for local development ports. It lists listening dev servers and leases free ports so parallel agents and worktrees do not collide.
The server does not stop processes.
Tools
Tool | Purpose |
| TCP listeners for the current user: port, pid, command, project directory, stack, URL, HTTP status |
| One port, including its reservation |
| A port that is not listening, not reserved, and can be bound |
| Framework default, or the next free port |
| Lease a port for a project or worktree (default 8 hours, maximum 7 days) |
| Drop a lease |
| Active leases |
Leases are stored in ~/.local-server-hub/reservations.json. Override the directory with LOCAL_SERVER_HUB_DIR.
Recognized stacks: Vite, Next, Nuxt, Astro, Angular, webpack, Remix, Django, Flask, FastAPI, Rails, PHP, Go, Spring, .NET, Rust, Node, and Docker port mappings.
On macOS, ports 5000 and 7000 carry a warning because AirPlay Receiver often binds them.
If lsof (macOS), ss (Linux), or netstat (Windows) is missing, the server probes the framework default ports instead. A missing docker binary skips container mappings and returns a warning.
Related MCP server: tidyports
Install
Requires Node.js 20 or newer.
Claude Code:
claude mcp add local-server-hub -- npx -y github:wieschollek/local-server-hubCursor ~/.cursor/mcp.json:
{
"mcpServers": {
"local-server-hub": {
"command": "npx",
"args": ["-y", "github:wieschollek/local-server-hub"]
}
}
}The published dist/ is what npx runs. From a checkout:
npm ci
npm test
npm run build
node dist/index.jsDevelopment
npm test
npm run buildGitHub Actions runs the tests on Ubuntu, macOS, and Windows.
This server cannot be deployed
Maintenance
Related MCP Connectors
Agent-native registry to discover APIs, MCP servers and CLIs, with live health checks.
Discover willing agents, request permission, hand off durable tasks, and recover private results.
Useful public tools, sourced notes and opt-in research into discovery and agent cooperation.
Discovery for the agent ecosystem: findable businesses, tools, knowledge, agent spaces, skills.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to discover, configure, and manage local development servers. Provides tools for app registration, port allocation, lifecycle control, and log access without manual config editing.426 npmMIT
- AlicenseNot gradedqualityDmaintenanceSee and control the local dev servers your coding agents leave running. Lists listeners with provenance — which agent, terminal and git worktree started each — kills strays, and allocates collision-free ports so parallel agents stop fighting over :3000.MIT
- AlicenseNot gradedqualityBmaintenanceEnables coding agents to inspect projects, claim worktrees, and move or start dev servers without changing ports, while coordinating with human-owned locks.18 npmMIT
- FlicenseAqualityCmaintenanceLets parallel DSH agent sessions on the same machine discover what each other is doing — which workspace, which tool is running, the latest human request and reply — so they can spot overlapping file edits and git races, and leave notes for one another on a shared append-only board.6-