agoraplus-saintmaur-mcp

Serveur MCP pour le portail famille Agora Plus de Saint-Maur-des-Fossés.

Statut : MVP lecture seule. Les réservations et annulations ne sont volontairement pas exposées. Les endpoints d'écriture doivent d'abord être capturés dans une session authentifiée, documentés et testés avec une confirmation explicite.

Ce que l'analyse du portail a confirmé

• Portail : https://portalssl.agoraplus.fr/smdf/
• Backend interne : https://smdf.agoraplus.fr/InternalApi/API_DASHBOARD/
• Consultation périscolaire observée : POST dashbord/inscription/peri
• Les appels authentifiés nécessitent une session ; aucune API publique documentée n'a été identifiée.

Installation

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e .
playwright install chromium

Configuration locale

cp .env.example .env
# Renseigner uniquement une session locale si nécessaire.
# Ne jamais committer .env, cookies, mots de passe ou jetons.

Le serveur se lance sur stdio :

agoraplus-saintmaur-mcp

Outils MCP exposés

• portal_info : métadonnées non sensibles ;
• initial_config : configuration du portail ;
• start_login : ouvre le profil Chromium persistant pour une connexion manuelle ;
• session_status : vérifie l’état apparent de la session ;
• peri_inscriptions : lecture des inscriptions périscolaires via la session navigateur.

Sécurité et limites

• aucune opération de réservation ou d'annulation n'est disponible dans cette version ;
• aucune authentification n'est demandée par le serveur lui-même ;
• les cookies de session sont lus uniquement depuis AGORAPLUS_SESSION_COOKIE ;
• ne pas utiliser un cookie permanent ou le compte d'une autre personne ;
• Agora Plus peut modifier ses endpoints internes sans préavis.

Développement

python -m pytest

Les prochaines étapes sont décrites dans docs/ROADMAP.md.