Skip to main content
Glama

FITOS SYSTEM

Sistema operativo físico personal de Alex: entreno con progresión propuesta, nutrición On/Off, cardio y reloj, y un servidor MCP con OAuth para manejarlo desde Muse. Sustituye a SISTEMA-ALEX-APP.

Estado, credenciales pendientes y lo que no está verificado: TRASPASO.md.

Arrancar en local (sin credenciales)

npm install
cp .env.example .env.local     # AUTH_MODE=dev ya viene puesto
npm run db:seed                # crea la base local (.data/pglite) y carga el catálogo
npm run import:legacy -- "../VIDA/_datos/supabase-2026-11-15"   # opcional: tus 102 sesiones
npm run dev

Sin DATABASE_URL la app usa PGlite: Postgres real embebido, con las mismas migraciones y el mismo RLS que producción. No hace falta Docker.

Related MCP server: fitness-mcp

Piezas

Carpeta

Qué hay

src/engine/

Motor científico: funciones puras con tests. Mapa en docs/MOTOR.md

supabase/migrations/

Esquema fit (no expuesto por la API de Supabase) con RLS por fila

src/db/client.ts

Una interfaz, dos motores (pg en producción, PGlite en local). withUser() activa el RLS

src/server/services/

Casos de uso: entreno, plan, bienestar, nutrición, cardio, salud, medios

src/server/oauth.ts, src/server/mcp/

Servidor OAuth 2.1 (registro dinámico, PKCE) y herramientas MCP

src/app/

PWA (Next.js 16) y rutas: /api/mcp, /api/ingest/health, /oauth/*, /.well-known/*

data/seed/

Catálogo: ejercicios, programas, glosario y alimentos

scripts/

Semillas, importación del histórico y extractores de los Excels

Comandos

Comando

Para qué

npm test

Motor, base de datos con RLS, servicios, OAuth y MCP

npm run typecheck

Tipos

npm run build

Compilación de producción

npm run db:seed

Migraciones (en Postgres) y catálogo. Idempotente

npm run import:legacy -- <carpeta>

Hereda el histórico de la app antigua. Idempotente

npm run hash-password

Genera OWNER_PASSWORD_HASH

Reglas del repo

  • .env* no se sube (solo .env.example). Las claves de la app antigua no se copian aquí.

  • Ninguna fórmula vive en una pantalla: todo cálculo está en src/engine/ con su test.

  • Todo dato del atleta pasa por withUser(). El rol propietario solo se usa para el alta, OAuth y tokens de ingesta.

  • Los Excels originales y los exports con datos personales se quedan fuera del repo.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP clients to read and update Garmin Connect data, including activities, health metrics, training status, and more, with per-account multi-tenant authentication.
      3
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables conversational logging and retrieval of workouts, sets, weigh-ins, meals, goals, plans, and progress photos through MCP-capable AI clients, with authenticated per-user storage and export/query capabilities.
      ISC
    • A
      license
      A
      quality
      B
      maintenance
      Enables an MCP client to read and write a personal Garmin Connect account: activities with per-set strength detail, daily health metrics (sleep, HRV, stress, steps, readiness), planned and completed workouts, and weigh-ins with body composition. It also logs finished strength sessions and body-composition readings as FIT files so they appear in Garmin Connect like natively recorded ones.
      38
      89 PyPI
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants and native clients to manage training plans, workout history, reusable recipes, meal records, and media through validated, versioned MCP and REST operations. It stores and validates structured fitness and nutrition data, including nutrition calculation, food catalog lookup, and Apple Health export status.
      MIT