Registry / devops / harbormaster-mcp

harbormaster-mcp

library27.0.0pypypi✓ verified 79d ago

Multi-project MCP router and operator dashboard for Claude Code, Codex, and Cursor. Version 27.0.0, active development. Ships a live web console with KPI strip, inter-project network graph, trace waterfall, memory editor, and multi-axis budgets. Part of the FleetQ ecosystem.

devops ai-ml

pip install harbormaster-mcp

github ↗homepage ↗

INSTALL

IMPORT

SIG · HARBORMASTER-MCP

harbormaster-mcp

devopspythonv27.0.0

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Harbormaster

✓ import harbormaster

✗ from harbormaster import Harbormaster

Initialize a Harbormaster router with multiple projects and optionally wrap it in a FastAPI app.

from harbormaster import Harbormaster, create_app # Initialize router router = Harbormaster( projects=[ {"name": "project-alpha", "path": "/path/to/alpha", "mcp_command": "uv run mcp"}, {"name": "project-beta", "path": "/path/to/beta"} ] ) # Or use FastAPI integration app = create_app(router) # To serve: uvicorn myapp:app --host 0.0.0.0 --port 8000

Debug

Known issues

breakingVersion 27.0.0 changed the default MCP transport from stdio to SSE. Projects that expect stdio must set transport='stdio' explicitly in project config.

fix

Add 'transport': 'stdio' to each project dict in Harbormaster configuration.

affects: >=27.0.0

breakingThe 'web' extra install group is no longer included by default. Web dashboard dependencies must be installed explicitly.

fix

Use pip install harbormaster-mcp[web] if you need the web console.

affects: >=25.0.0

deprecatedThe 'projects' argument to Harbormaster now expects a list of dicts with 'name', 'path', and optional 'mcp_command'. Old format (tuple of (name, path)) was deprecated in v24 and removed in v26.

fix

Use dict format: {'name': 'proj', 'path': '/path', 'mcp_command': '...'}.

affects: >=26.0.0

gotchaSSH-hosted projects require the remote machine to have harbormaster-mcp installed and a running MCP server. The router does not auto-install on remote hosts.

fix

Ensure the remote machine has harbormaster-mcp installed and the MCP server is reachable on the given host/port.

affects: all

Upgrade

Version history

27.0.0latest on PyPI · released Jun 1, 2026

Audit

Dependencies

fastapirequiredRequired for web dashboard

uvicornrequiredRequired for web dashboard server

Agent activity

20 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/FleetQ/harbormaster ↗

homepagehttps://github.com/FleetQ/harbormaster ↗