launcher-project-registry

Summary

Launcher Project Registry is a self-hosted system for tracking development projects with their locations, ports, URLs, and tech stacks in a single JSON datastore. It pairs a Flask admin web UI (port 8766) with a FastMCP server (port 8765) so developers and AI tools can query project information over SSE, while a cron-ready port scanner keeps in-use and free port data current. Set up via an automatic installer or a manual venv, then manage projects through REST endpoints or 12+ MCP tools.

Proof Points

• Exposes 14 MCP tools for AI integration, including project search, free-port discovery, tech-stack queries, and a Dynamic MCP catalogue importer.
• Includes a cron-compatible port scanner (via system ss) that syncs live port usage into the registry on a 15-minute schedule.
• Ships with a Flask admin UI and REST API (8+ endpoints) plus systemd service units for deployment.
• Features a portfolio audit script that flags dirty git working trees and missing AGENTS.md/CONTEXT.md files across projects.
• Provides built-in registry hygiene tools like path-based deduplication and a migration script.