EduBase MCP Server

officiel

Interagissez avec EduBase, une plateforme d'apprentissage en ligne complète dotée de fonctionnalités avancées de quiz, de gestion d'examens et d'organisation de contenu.

GitHub

Documentation

Serveur MCP EduBase

Ce dépôt contient l'implémentation du Model Context Protocol (MCP) serveur 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.

EduBase MCP demo GIF: Claude uploads math questions

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 ou 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 typographique 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 unique
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é au 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, tels qu'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 collaborative et téléchargement de questions, planification d'examens et analyse des résultats des utilisateurs avec Claude :

Demonstrating EduBase's MCP server to collaboratively create and upload questions, schedule exams and analyze results.

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 à [email protected].

Outils

Chaque point de terminaison 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	Requise	Valeur par défaut
`EDUBASE_API_URL`	L'URL de base de l'API EduBase, très probablement `https://subdomain.edubase.net/api`.	Oui	`https://www.edubase.net/api`
`EDUBASE_API_APP`	L'ID d'application de votre 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 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 en tant que 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`

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 soit avec le mode de transport SSE, soit avec le mode 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 de deux manières :

Sans authentification client : Dans ce mode, le serveur n'exigera aucune authentification de la part du client. Cela est utile à des fins de test ou de développement, ou dans un réseau fermé, mais ce n'est pas recommandé pour une utilisation en production. Pour cela, vous devez également configurer le serveur avec le EDUBASE_API_APP et le 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és 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 en tant que fournisseur d'identité) : 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 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) en tant que serveur distant. Nous vous recommandons d'encoder en Base64 votre EDUBASE_API_APP et votre EDUBASE_API_KEY et de les 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 le serveur MCP EduBase pour Claude Desktop automatiquement via Smithery :

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

Contact

Site web : www.edubase.net
Documentation développeur : developer.edubase.net
Email : [email protected]