Skip to main content
Glama
novaiax

NovaFormation MCP Server

by novaiax
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

NovaFormation — serveur MCP

Serveur MCP distant de NovaFormation (programmes de formation, livres, exercices, objectifs, XP). Il donne à un client MCP un accès complet en lecture et écriture aux données de l'application, avec les mêmes règles que l'interface.

  • Lit et écrit directement la base Supabase de l'application (clé service_role), chaque requête étant limitée au compte NovaFormation.

  • Les règles métier de l'app sont reprises à l'identique (src/domain, src/services) : XP accordée une seule fois et retirée à l'annulation, progression des programmes, objectifs d'exercice franchis enregistrés une seule fois.

  • Toute suppression est définitive et exige confirm: true. Pour ranger sans rien perdre : update_program avec status: "archived", update_exercise avec archived: true.

  • Les sections Today et Habits, masquées dans l'app, ne sont pas exposées.

Outils

Domaine

Outils

Vue d'ensemble

get_overview, get_statistics, list_xp_events, search

Programmes

list_programs, get_program, create_program (structure complète en un appel), update_program, delete_program, add_weeks, update_week, delete_week, add_modules, update_module, delete_module, add_module_items, update_module_item, set_module_items_completed, reorder_module_items, delete_module_items

Livres

list_books, get_book, create_book, update_book, update_book_progress, delete_book

Exercices

list_exercises, get_exercise, create_exercise, update_exercise, list_exercise_sessions, log_exercise_session, update_exercise_session, delete_exercise_session

Objectifs

add_exercise_objectives, set_exercise_objectives, update_exercise_objective, delete_exercise_objective, list_milestones

Réglages

get_settings, update_settings, update_profile, list_categories, create_category, update_category, merge_categories, delete_category

Un échec renvoie un résultat isError contenant {"error": {"code": "not_found", "message": "..."}} — codes : bad_request, not_found, conflict, unavailable, server_error.

Related MCP server: Gym Coach MCP Server

Points d'entrée

Chemin

Rôle

GET /sse + POST /messages

transport SSE (connecteurs claude.ai)

POST /mcp

transport Streamable HTTP, sans état

GET /health

état du serveur (public)

Authentification

Avec MCP_AUTH_TOKEN, le client fournit le jeton par l'en-tête Authorization: Bearer <jeton> ou, s'il n'accepte qu'une URL, dans l'adresse : https://mcp.exemple.fr/sse?token=<jeton> ou https://mcp.exemple.fr/mcp?token=<jeton>. /health reste public ; /.well-known/* répond 404 (pas de fournisseur OAuth).

Configuration

Variable

Défaut

Rôle

SUPABASE_URL

— (obligatoire)

URL du projet Supabase de NovaFormation

SUPABASE_SERVICE_ROLE_KEY

— (obligatoire)

Clé service_role (Project Settings › API)

NOVAFORMATION_USER_ID

vide

Compte ciblé ; vide = l'unique compte de l'app

MCP_AUTH_TOKEN

vide

Jeton exigé ; vide = serveur ouvert

MCP_HOST / MCP_PORT

0.0.0.0 / 8080

Écoute

MCP_PUBLIC_URL

vide

Adresse publique (affichée au démarrage)

La base doit avoir les migrations de l'application appliquées, dont 0004_exercise_goals.sql pour les objectifs et milestones (sans elle, les outils d'objectifs répondent unavailable et le reste fonctionne).

Développement

npm install
cp .env.example .env    # puis renseigner les variables
npm run build && node --env-file=.env dist/index.js
npm test                # logique métier + protocole MCP (SSE et Streamable HTTP)

Déploiement (Docker / Coolify)

docker build -t novaformation-mcp .
docker run -p 8080:8080 --env-file .env novaformation-mcp

Coolify : ressource depuis ce dépôt, build pack Dockerfile, port exposé 8080, variables ci-dessus. Le healthcheck de l'image interroge /health.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Gym Coach MCP Server

    nicosaporiti
    F
    license
    Not graded
    quality
    D
    maintenance
    Connects to a Gym Tracker Supabase database to provide LLMs with access to personal workout history, routines, and training progress. It enables users to analyze fitness performance, track personal records, and receive personalized coaching advice through natural language.
    -

  • Health Coach MCP

    brian7989
    F
    license
    Not graded
    quality
    C
    maintenance
    A personal health and fitness MCP server that provides tools for managing profile data, goals, body measurements, nutrition, workouts, sleep, check-ins, life events, analytics, and coach memories via Supabase Postgres.
    1
    -