Cartable
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Cartable
Serveur MCP en lecture seule pour EcoleDirecte. 61 outils, une session, aucune écriture.
Cartable donne à un client MCP (Claude Desktop, Claude Code, Cursor, …) l'accès aux données d'un compte élève EcoleDirecte : notes et bulletins, cahier de textes, emploi du temps, vie scolaire, messagerie, documents, cantine, formulaires et espaces de travail.
Avertissement
Projet non officiel, sans aucune affiliation, partenariat ni approbation d'Aplim ou d'EcoleDirecte, dont les noms et marques appartiennent à leurs propriétaires respectifs. Il est destiné à l'usage personnel du titulaire du compte, dans un cadre privé ou éducatif, et n'est ni redistribué, ni revendu, ni mis à disposition de tiers.
L'utilisateur est seul responsable de son usage : il lui appartient de vérifier que celui-ci respecte les conditions d'utilisation du service, les textes en vigueur et les droits des tiers. Le logiciel est fourni « en l'état », sans garantie d'aucune sorte.
Le client API embarqué (ecoledirecte_api) dérive de
hacf-fr/ecoledirecte_api et reste
sous LGPL-3.0-or-later ; voir NOTICE et COPYING.GPL-3.0.
Related MCP server: librus-mcp
Points clés
Lecture seule, garantie à la couche HTTP : le client refuse toute méthode autre que
POSTet toutverbeautre queget/list, même si un outil était mal écrit. Aucun outil d'envoi, de commande ou de suppression n'est exposé.61 outils couvrant tout ce qu'un élève voit sur le site, plus
ed_get_catalog(inventaire) eted_raw_query(échappatoireGETcontrôlée).Une seule session HTTP keep-alive,
X-Tokencapturé à chaque réponse : aucun re-login inutile entre deux outils.Cache TTL mémoire et déduplication des lectures parallèles : deux outils qui demandent la même donnée ne déclenchent qu'une requête.
Compatible Raspberry Pi (Python 3.11+), avec une unité systemd fournie.
Couverture
Domaine | Outils |
Session |
|
Élève |
|
Notes |
|
Cahier de textes |
|
Emploi du temps |
|
Vie scolaire |
|
Messagerie |
|
Documents |
|
Cantine |
|
Espaces & cloud |
|
Méta |
|
Les outils réellement exposés sont filtrés par les modules activés côté établissement.
Installation
Python 3.11 à 3.13 (3.13 recommandé) :
$ git clone <url-de-ce-depot> cartable-mcp
$ cd cartable-mcp
$ python3 -m venv .venv && . .venv/bin/activate
$ pip install -e '.[mcp,fast]' # 'fast' ajoute uvloop (optionnel, hors Windows)Sur Raspberry Pi OS Bookworm, sudo apt install python3 python3-venv suffit
ensuite.
Configuration
Les identifiants ne vont jamais dans le dépôt. Deux possibilités :
$ mkdir -p ~/.config/ecoledirecte-mcp
$ cat > ~/.config/ecoledirecte-mcp/credentials.json <<'JSON'
{"username": "identifiant", "password": "motdepasse"}
JSON
$ chmod 600 ~/.config/ecoledirecte-mcp/credentials.jsonou les variables ED_USERNAME / ED_PASSWORD (prioritaires sur le fichier).
Variable | Défaut | Rôle |
|
| Fichier JSON |
|
| Réponses QCM mémorisées (écrites en |
|
| Token de session réutilisé au redémarrage (écrit en |
|
| Durée de réutilisation d'un token enregistré, en heures |
|
| Dossier des pièces jointes |
|
| Verrou lecture seule côté client HTTP |
|
| Durée du cache mémoire, en secondes |
|
| Espacement minimal entre deux appels |
|
| Budget d'appels API par minute |
|
| Timeout HTTP, en secondes |
|
| Taille maximale d'un téléchargement |
|
| Fuseau utilisé pour « aujourd'hui » |
| valeurs du client | Surcharge de l'endpoint ou de la version d'API |
|
| Niveau de log (sur stderr) |
Brancher un client MCP
Transport stdio, par exemple :
{
"mcpServers": {
"cartable": {
"command": "/opt/ecoledirecte/.venv/bin/ecoledirecte-mcp",
"env": {
"ED_CREDENTIALS_FILE": "/etc/ecoledirecte-mcp/credentials.json",
"ED_QCM_FILE": "/var/lib/ecoledirecte-mcp/qcm.json",
"ED_DOWNLOAD_DIR": "/var/lib/ecoledirecte-mcp/downloads",
"ED_READ_ONLY": "true",
"ED_TIMEZONE": "Europe/Paris"
}
}
}
}Un exemple complet est fourni dans deploy/claude-desktop.json, et l'unité
systemd durcie dans deploy/ecoledirecte-mcp.service.
Le serveur démarre lui-même la session : appeler ed_get_context.
Si la réponse contient status=qcm_required, demander la réponse à l'utilisateur
puis appeler ed_submit_qcm ; elle est mémorisée pour les connexions suivantes.
Ce fichier n'est qu'un confort de connexion, stocké en 0600 : le supprimer (ou
repointer ED_QCM_FILE) à tout moment ramène à une saisie manuelle.
Utiliser le client en Python
Le paquet embarque aussi le client asynchrone dont dépend le serveur :
import asyncio
from ecoledirecte_api.client import EDClient
async def main():
async with EDClient("username", "password", {}) as client:
await client.login()
print(await client.get_homeworks("student_id"))
asyncio.run(main())Si le compte exige un QCM, fournir les réponses dans l'argument qcm_json.
Transport HTTP (optionnel)
ecoledirecte-mcp-http expose le même serveur en Streamable HTTP sur
http://127.0.0.1:8765/mcp, protégé par une clé privée :
$ export ED_HTTP_API_KEY_FILE=~/.config/ecoledirecte-mcp/api-key # 0600, 32+ caractères
$ ecoledirecte-mcp-httpChaque requête doit porter Authorization: Bearer <clé>.
ED_HTTP_HOST doit rester une adresse de bouclage et, par défaut, seuls les hôtes
de bouclage sont acceptés. Pour exposer le serveur derrière un tunnel TLS, lister
les hôtes publics dans ED_HTTP_ALLOWED_HOSTS, séparés par des virgules :
host[:port] autorise l'hôte et déduit ses origines http/https, alors qu'une
entrée https://host n'ajoute que cette origine. ED_HTTP_PORT change le port.
Sécurité
Aucune écriture : pas d'envoi de message, de commande ni de suppression. Seule l'ouverture d'un message peut le marquer comme lu côté EcoleDirecte, exactement comme sur le site.
Secrets : identifiants et fichier QCM doivent être en
0600(refus explicite sinon), les dossiers sont créés en0700, les mots de passe sont masqués dans les erreurs.Entrées strictes : dates, identifiants, années scolaires et bornes de pagination sont validés avant toute construction d'URL ;
ed_raw_queryrefuse les routes d'authentification, d'upload et de téléchargement.Téléchargements : confinés dans
ED_DOWNLOAD_DIR, permissions0600, taille plafonnée, streaming.Réseau : pas de proxy implicite (
.netrcetHTTP_PROXYignorés), TLS vérifié, budget de requêtes par minute.Contenu non fiable : les textes EcoleDirecte sont traités comme des données, jamais comme des instructions.
Disque : aucun secret ni donnée scolaire persistés, hormis le fichier QCM et les pièces jointes demandées.
Développement
$ poetry install --with dev
$ poetry run ruff check src tests
$ poetry run mypy
$ poetry run pytestUn DevContainer Python est fourni dans .devcontainer/. La CI GitHub Actions
exécute Ruff, mypy et la suite de tests.
Licence et crédits
Distribué sous LGPL-3.0-or-later :
LICENSE— texte de la GNU Lesser General Public License v3.0 ;COPYING.GPL-3.0— texte de la GNU GPL v3.0, dont la LGPL-3.0 reprend les termes et conditions ;NOTICE— attribution, périmètre du travail dérivé et liste des modifications.
Le client EcoleDirecte (src/ecoledirecte_api) est dérivé du projet
hacf-fr/ecoledirecte_api de Giga77,
utilisé par l'intégration Home Assistant
hass-ecoledirecte. Merci à eux.
La couche MCP (src/ecoledirecte_mcp) et les adaptations du client constituent
les modifications apportées à ce travail dérivé.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read your plat.plus courses, tasks, course pages, sessions, files and messages. Read-only.
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
Read-only access to a student's recorded classes: transcripts, notes, slides and concept map.
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Related MCP Servers
- AlicenseAqualityCmaintenanceRead-only MCP server for Canvas LMS that exposes tools to list courses, assignments, grades, submissions, syllabi, announcements, modules, pages, and files, without any write operations.1116 npm1MIT
- FlicenseAqualityCmaintenanceEnables read-only access to a Librus Portal account, letting users list linked Synergia accounts and retrieve grades, attendance, timetable, homework, notices, and school information.3-
- FlicenseNot gradedqualityBmaintenanceConnects AI agents to the École Directe API to access grades, homework, timetables, school life, messages, and documents.-
- FlicenseAqualityBmaintenanceProvides read-only access to Librus parent account data for multiple children, enabling retrieval of grades, attendance, timetable, calendar, homework, announcements, messages, and attachments via MCP.111-