agoraplus-saintmaur-mcp

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

Version 0.2 : strictement lecture seule. Le code n'implémente aucun endpoint de réservation, annulation, paiement, suppression ou modification.

Fonctionnalités

• session Chromium persistante dans un profil privé ;

• connexion automatique facultative par courriel/mot de passe depuis .env ;

• repli manuel dans noVNC pour MFA, CAPTCHA ou changement du portail ;

• statut de connexion sans cookies ni secrets ;

• lecture des inscriptions via l'endpoint observé POST dashbord/inscription/peri ;

• calendrier et bilan hebdomadaire calculés localement à partir de cette même réponse de lecture ;

• transport MCP stdio, en local ou dans Docker.

Le formulaire public observé le 3 août 2026 expose les champs accessibles Courriel, Mot de passe et le bouton Login. Cette interface interne n'est pas contractuelle : si elle change, la tentative automatique s'arrête et noVNC reste disponible. Aucun endpoint de connexion n'est inventé ni appelé directement.

Related MCP server: mcp-datagouv

Démarrage Docker recommandé

cp .env.example .env
# Éditer .env : renseigner AGORAPLUS_USERNAME, AGORAPLUS_PASSWORD et
# obligatoirement un VNC_PASSWORD long et unique.
docker compose build
docker compose run --rm --service-ports mcp

Le processus reste un serveur MCP stdio. noVNC est disponible pendant son exécution sur http://127.0.0.1:6080/vnc.html (ou NOVNC_PORT). Appelez d'abord start_login. Si la connexion automatique ne suffit pas, ouvrez noVNC et terminez la connexion. Le profil et les cookies restent dans le volume nommé agoraplus-browser-data.

Exemple générique de configuration d'un client MCP, avec un chemin absolu :

{
  "command": "docker",
  "args": [
    "compose",
    "-f",
    "/chemin/absolu/agoraplus-saintmaur-mcp/docker-compose.yml",
    "run",
    "--rm",
    "--service-ports",
    "mcp"
  ]
}

Une seule instance doit publier le port noVNC. Pour un second client simultané, utilisez un autre NOVNC_PORT ou retirez --service-ports après initialisation du profil.

Installation locale

python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[test]'
python -m playwright install chromium
cp .env.example .env
agoraplus-saintmaur-mcp

Un affichage X est nécessaire avec AGORAPLUS_HEADLESS=false. Docker fournit Xvfb et noVNC pour ce cas.

Outils MCP

• portal_info : portée et métadonnées non sensibles ;

• initial_config : configuration publique du portail ;

• start_login : démarre Chromium, réutilise le profil et tente le formulaire de connexion observé ;

• connection_status : état de la session ;

• session_status : alias conservé pour compatibilité ;

• inscriptions : réponse brute de lecture des inscriptions ;

• peri_inscriptions : alias conservé pour compatibilité ;

• reservations_calendar : vue locale filtrée par dates ;

• weekly_summary : bilan local du lundi au dimanche.

Le payload de l'endpoint interne dépend du portail. Après start_login, ouvrez une fois la page des inscriptions dans Chromium/noVNC : le serveur mémorise uniquement le dernier payload envoyé à l'URL de lecture autorisée. Il peut aussi être fourni explicitement aux outils. Aucun autre POST n'est mémorisé ou exposé.

Limites connues

• l'API Agora Plus est interne et non documentée publiquement ;

• l'authentification et la forme du payload peuvent changer sans préavis ;

• l'état authentifié est estimé à partir du profil, des cookies et de l'absence du formulaire de connexion ;

• le calendrier reconnaît des dates ISO (YYYY-MM-DD) et françaises (DD/MM/YYYY) dans les réponses ; les données brutes et leur chemin source sont conservés dans chaque entrée ;

• aucune écriture ne sera ajoutée sans analyse séparée et validation explicite.

Consultez docs/DEPLOYMENT.md, docs/SECURITY.md et docs/ROADMAP.md.

Validation

python -m pytest
python -m compileall -q src tests
docker compose config
docker compose build