Skip to main content
Glama
FelipeDanielH

todo-hud-mcp

by FelipeDanielH
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Hybrid

Focus HUD Monorepo

Backend POC + desktop UI for Focus HUD, a lightweight todo + gamified pomodoro app.

Structure

apps/api/               # NestJS backend (REST + MCP)
packages/shared/        # Shared contracts/types (future)
infra/docker/           # Docker Compose config
infra/caddy/            # Caddy reverse proxy config (future)
docs/adr/               # Architecture Decision Records

Quick start (backend)

cd apps/api
npm install
npm run build
npm start

Server at http://localhost:3000. Swagger at /docs.

Docker

docker compose up -d --build

MCP

  • HTTP: POST /mcp (inside NestJS)

  • Stdio: cd apps/api && npm run mcp

Docs