EduBase

Serveur MCP EduBase

Ce dépôt contient l'implémentation du Model Context Protocol (MCP) pour la plateforme EduBase. Il permet aux clients MCP (par exemple Claude Desktop) et aux LLM d'interagir avec votre compte EduBase et d'effectuer des tâches en votre nom. Il prend en charge les protocoles de transport stdio, SSE et HTTP streamable.

Qu'est-ce qu'EduBase ?

EduBase est une plateforme éducative en ligne innovante, modulaire, qui rend l'apprentissage plus agréable, plus simple et interactif, adaptée aux établissements d'enseignement comme aux entreprises.

Pourquoi choisir EduBase ?

EduBase révolutionne l'apprentissage numérique grâce à sa combinaison unique de fonctionnalités :

• Système de quiz avancé avec paramétrage permettant des variations infinies d'une même question, détection de triche en temps réel, composition LaTeX de qualité, prise en charge avancée des STEM et correction automatique
• Environnement d'apprentissage unifié qui centralise tout votre contenu éducatif — vidéos, examens, documents et modules SCORM — dans un système intuitif
• Sécurité de niveau entreprise avec des fonctionnalités telles que l'intégration SSO, des contrôles d'accès granulaires, un audit complet et la conformité RGPD
• Intégration avec vos systèmes existants via LTI, une API complète et des options d'intégration personnalisées
• Outils assistés par IA, comme EduBase Assistant, qui peuvent transformer instantanément votre contenu existant en quiz et évaluations interactifs, ou traduire vos supports d'une langue à une autre

Des établissements d'enseignement supérieur aux départements de formation en entreprise, EduBase s'adapte à vos besoins spécifiques tout en maintenant une expérience utilisateur intuitive sur tous les appareils.

Vidéo de démonstration

Création et téléchargement collaboratifs de questions, planification d'examens et analyse des résultats des utilisateurs avec Claude :

Obtention de vos identifiants API

Une fois connecté, sur votre tableau de bord, recherchez le menu Intégrations, cliquez sur « ajouter une intégration » et choisissez le type « EduBase API ».

Si vous ne voyez pas cette option, saisissez le code d'activation MCPGITHUB ou n'hésitez pas à nous contacter pour demander l'accès à info@edubase.net.

Outils

Chaque point de terminaison d'API documenté est disponible en tant qu'outil distinct, nommé edubase_<method>_<endpoint>. Par exemple, l'outil pour le point de terminaison GET /user:me est nommé edubase_get_user_me. Consultez notre documentation développeur pour plus d'informations.

Configuration

Le serveur MCP peut être configuré à l'aide de variables d'environnement. Les variables suivantes sont disponibles :

Variable	Description	Requis	Valeur par défaut
EDUBASE_API_URL	L'URL de base de l'API EduBase, probablement https://subdomain.edubase.net/api.	Oui	https://www.edubase.net/api
EDUBASE_API_APP	L'ID d'application de votre application d'intégration sur EduBase, le app sur l'API EduBase. Trouvez-le dans la fenêtre des détails de l'intégration sur EduBase.	Non si le transport HTTP est utilisé avec authentification, sinon Oui	-
EDUBASE_API_KEY	La clé secrète de votre application d'intégration sur EduBase, le secret sur l'API EduBase. Trouvez-la avec l'ID d'application dans la fenêtre des détails de l'intégration sur EduBase.	Non si le transport HTTP est utilisé avec authentification, sinon Oui	-
EDUBASE_SSE_MODE	Démarrer le serveur MCP en mode HTTP avec transport SSE. La valeur doit être true.	Non	false
EDUBASE_STREAMABLE_HTTP_MODE	Démarrer le serveur MCP en mode HTTP avec transport HTTP streamable. La valeur doit être true.	Non	false
EDUBASE_HTTP_PORT	Le serveur HTTP écoutera sur ce port si le mode de transport SSE ou HTTP streamable est utilisé.	Non	3000
EDUBASE_OAUTH	Active le comportement de ressource protégée OAuth 2.1 : les requêtes non authentifiées sont rejetées avec 401 + WWW-Authenticate pointant vers /.well-known/oauth-protected-resource, et les jetons Bearer sont transmis à l'API EduBase.	Non	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	URL de base publique du déploiement EduBase agissant comme fournisseur d'identité OAuth. Utilisée pour annoncer le serveur d'autorisation dans le document de métadonnées de la ressource protégée.	Non	dérivée de EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	URL de base publique de ce serveur MCP (l'indicateur de ressource OAuth). Utilisée dans l'en-tête WWW-Authenticate et les métadonnées de ressource.	Non	dérivée de EDUBASE_API_URL
EDUBASE_ALLOW_PRIVATE_NETWORK	Lorsqu'un transport HTTP est utilisé, l'outil edubase_filebin bloque les requêtes sortantes vers les adresses privées, de bouclage, lien-local et réservées (protection SSRF) et refuse les chemins de fichiers locaux. Définissez sur true pour les autoriser, par exemple pour un déploiement auto-hébergé sur un réseau privé de confiance. N'a aucun effet en mode stdio, où l'utilisateur local est le seul appelant.	Non	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	Liste facultative, séparée par des virgules, de noms d'hôtes autorisés comme cibles de téléchargement edubase_filebin (hôte exact ou tout sous-domaine, par exemple edubase.net). Lorsqu'elle est vide, tout hôte public est autorisé (toujours soumis au filtrage d'adresses ci-dessus).	Non	-

Utilisation en tant que serveur MCP distant

Vous pouvez utiliser le serveur MCP EduBase en tant que serveur MCP distant pour votre client MCP. Pour ce faire, vous devez héberger le serveur MCP là où les clients peuvent y accéder, puis configurer le client pour qu'il se connecte au serveur. Démarrez-le avec le mode de transport SSE ou HTTP streamable et utilisez toujours HTTPS lorsque vous accédez au serveur à distance via Internet !

Authentification avec les serveurs distants

Vous pouvez utiliser le serveur selon deux modes :

• Sans authentification client : Dans ce mode, le serveur n'exigera aucune authentification de la part du client. Ceci est utile pour les tests ou le développement, ou dans un réseau fermé, mais n'est pas recommandé pour une utilisation en production. Pour cela, vous devez également configurer le serveur avec les EDUBASE_API_APP et EDUBASE_API_KEY !
• Avec authentification par jeton Bearer : Dans ce mode, le serveur exigera qu'un jeton Bearer soit envoyé avec chaque requête. C'est la méthode recommandée pour utiliser le serveur en production. Vous pouvez obtenir le jeton Bearer depuis votre compte EduBase en créant une application d'intégration et en fournissant l'ID d'application et la clé secrète au format {app}:{secret}, encodé en base64 comme jeton. Le serveur utilisera ensuite ce jeton pour authentifier le client et autoriser l'accès aux points de terminaison de l'API.
• Avec OAuth 2.1 (EduBase comme IdP) : Lorsque EDUBASE_OAUTH=true, les clients compatibles (Claude Desktop, connecteurs Claude.ai, Cursor, connecteurs ChatGPT, etc.) découvrent le serveur d'autorisation EduBase via /.well-known/oauth-protected-resource, s'enregistrent dynamiquement (RFC 7591), guident l'utilisateur à travers un écran de consentement EduBase, et échangent un code d'autorisation (avec PKCE S256) contre un jeton d'accès opaque. Le serveur MCP transmet ce jeton tel quel à l'API EduBase, qui le résout en l'intégration MCP provisionnée automatiquement, créée lors du premier consentement. Pas d'ID d'application/Secret à copier — les utilisateurs cliquent simplement sur « Connecter EduBase » dans leur client.

Utilisation avec Claude Desktop

Pour un guide étape par étape, consultez notre article de blog sur comment connecter EduBase avec Claude : Le guide complet d'intégration MCP.

Utilisation du serveur MCP EduBase fourni

Vous pouvez utiliser le serveur MCP EduBase fourni (si disponible) sans aucune configuration, simplement en l'ajoutant comme serveur distant dans votre client avec l'URL https://domain.edubase.net/mcp (remplacez par le domaine réel), s'il prend en charge l'authentification OAuth, ou avec le jeton Bearer approprié dans l'en-tête Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Recommandé pour les utilisateurs de www.edubase.net, car le serveur est maintenu et mis à jour par nos soins, et vous n'avez pas à vous soucier de l'hébergement ou de la configuration. Assurez-vous simplement d'utiliser l'URL et la méthode d'authentification correctes lors de la connexion de votre client.

Installation manuelle

Ajoutez ce qui suit à votre claude_desktop_config.json :

Utilisation de Node.js

Avant d'exécuter le serveur MCP, assurez-vous que Node.js est installé. Vous pouvez le télécharger depuis nodejs.org ou utiliser un gestionnaire de paquets comme brew.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "-y",
        "@edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Ou téléchargez la version du serveur MCP EduBase ou clonez le dépôt et exécutez npm run build pour construire le serveur. N'oubliez pas d'ajuster /path/to/dist au répertoire réel et de configurer les variables d'environnement !

{
  "mcpServers": {
    "edubase": {
      "command": "node",
      "args": [
        "/path/to/dist/index.js"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Utilisation de Docker

Avant d'exécuter le serveur MCP, assurez-vous que Docker est installé et en cours d'exécution. Vous pouvez le télécharger depuis docker.com ou utiliser un gestionnaire de paquets. N'oubliez pas de configurer les variables d'environnement !

{
  "mcpServers": {
    "edubase": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "EDUBASE_API_URL",
        "-e",
        "EDUBASE_API_APP",
        "-e",
        "EDUBASE_API_KEY",
        "edubase/mcp"
      ],
      "env": {
        "EDUBASE_API_URL": "https://domain.edubase.net/api",
        "EDUBASE_API_APP": "your_integration_app_id",
        "EDUBASE_API_KEY": "your_integration_secret_key"
      }
    }
  }
}

Installation via un serveur MCP distant

Vous pouvez utiliser le serveur MCP EduBase fourni (si disponible) comme serveur distant. Nous recommandons d'encoder en Base64 votre EDUBASE_API_APP et EDUBASE_API_KEY et de l'utiliser comme jeton Bearer dans l'en-tête Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

Installation via Smithery

Pour installer automatiquement le serveur MCP EduBase pour Claude Desktop via Smithery :

npx -y @smithery/cli install @EduBase/MCP --client claude

Contact

Site web : www.edubase.net
Documentation développeur : developer.edubase.net
Email : info@edubase.net