Skip to main content
Glama

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

list_servers

TCP listeners for the current user: port, pid, command, project directory, stack, URL, HTTP status

get_port_info

One port, including its reservation

find_free_port

A port that is not listening, not reserved, and can be bound

suggest_port

Framework default, or the next free port

reserve_port

Lease a port for a project or worktree (default 8 hours, maximum 7 days)

release_port

Drop a lease

list_reservations

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-hub

Cursor ~/.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.js

Development

npm test
npm run build

GitHub Actions runs the tests on Ubuntu, macOS, and Windows.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables 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 npm
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    See 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
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables coding agents to inspect projects, claim worktrees, and move or start dev servers without changing ports, while coordinating with human-owned locks.
    18 npm
    MIT
  • F
    license
    A
    quality
    C
    maintenance
    Lets 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
    -