coordination-mcp

FastMCP-based Coordination Message Bus for the VPS Autonomous System.

Quick start (local)

# 0) Install deps (PEP 517 build; no secrets)
python -m venv .venv
source .venv/bin/activate
pip install -e .

# 1) Initialize DB (writes coordination.db in repo root)
python coordination_mcp/db/init.py

# 2a) STDIO transport (for local MCP clients)
python run_stdio.py

# 2b) SSE transport (auto-picks Tailscale IP; override with MCP_HOST/MCP_PORT)
MCP_HOST=127.0.0.1 MCP_PORT=8321 python run_server.py
# => endpoint: http://$MCP_HOST:$MCP_PORT/sse

# 2c) REST shim (local-only by default)
HTTP_HOST=127.0.0.1 HTTP_PORT=8000 python http_api.py
curl http://127.0.0.1:8000/healthz

Notes:

• No auth baked in; front with Tailscale allowlist or reverse proxy as needed.
• Default DB is local SQLite; change path via env vars in coordination_mcp/db/utils.py if you want another location.