harbormaster

ryancalpin/harbormaster

★ 0 stars Unknown language 🤖 AI/LLM Updated today

Port allocation daemon + TUI for developers and AI agents. Hard socket-based port locking with negotiation API and MCP server.

View on GitHub →

Quick Install

Copy the config for your editor. Some servers may need additional setup — check the README.

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "harbormaster": {
      "command": "npx",
      "args": [
        "-y",
        "ryancalpin/harbormaster"
      ]
    }
  }
}

README Excerpt

> A port allocation daemon and TUI for developers and AI agents. Like a real harbormaster — controls which ships dock at which berths, turns away unauthorized vessels, and assigns open slips on request. **Status: Design phase — PRs and feedback welcome** --- AI agents and dev services constantly race for the same ports. One agent starts on `:3000`, another one spins up and steals it, everything breaks. There's no standard way for processes to negotiate ports before binding, and no way to protect

Tools (6)

aiosqliteclaimedfreelist_portslockedreserved

harbormaster

Quick Install

README Excerpt

Tools (6)

Related AI/LLM Servers