EduBase MCP Server

offiziell

Interagiere mit EduBase, einer umfassenden E-Learning-Plattform mit erweiterten Funktionen für Quiz, Prüfungsverwaltung und Inhaltsorganisation.

GitHub

Dokumentation

EduBase MCP-Server

Dieses Repository enthält die Implementierung des Model Context Protocol (MCP)-Servers für die EduBase-Plattform. Es ermöglicht MCP-Clients (z. B. Claude Desktop) und LLMs, mit Ihrem EduBase-Konto zu interagieren und Aufgaben in Ihrem Auftrag auszuführen. Es unterstützt die Transportprotokolle stdio, SSE und streamfähiges HTTP.

EduBase MCP demo GIF: Claude uploads math questions

Was ist EduBase?

EduBase ist eine innovative, modulare Online-Bildungsplattform, die das Lernen angenehmer, einfacher und interaktiver macht und sich für Bildungseinrichtungen oder Unternehmen eignet.

Warum EduBase?

EduBase revolutioniert das digitale Lernen mit seiner einzigartigen Kombination von Funktionen:

Fortschrittliches Quiz-System mit Parametrisierung, die unendliche Variationen derselben Frage ermöglicht, Echtzeit-Betrugserkennung, ansprechendem LaTeX-Satz, erweiterter MINT-Unterstützung und automatischer Bewertung
Einheitliche Lernumgebung, die alle Ihre Bildungsinhalte – Videos, Prüfungen, Dokumente und SCORM-Module – in einem intuitiven System zentralisiert
Sicherheit auf Unternehmensniveau mit Funktionen wie SSO-Integration, fein abgestuften Zugriffskontrollen, umfassender Prüfung und DSGVO-Konformität
Integration mit Ihren bestehenden Systemen durch LTI, umfassende API und benutzerdefinierte Integrationsoptionen
KI-gestützte Werkzeuge, wie der EduBase-Assistent, die Ihre vorhandenen Inhalte sofort in interaktive Quizze und Bewertungen umwandeln oder Ihre Materialien von einer Sprache in eine andere übersetzen können

Von Hochschuleinrichtungen bis hin zu betrieblichen Schulungsabteilungen skaliert EduBase, um Ihre spezifischen Anforderungen zu erfüllen, und bietet gleichzeitig eine intuitive Benutzererfahrung auf allen Geräten.

Demo-Video

Gemeinsames Erstellen und Hochladen von Fragen, Planen von Prüfungen und Analysieren von Benutzerergebnissen mit Claude:

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

Erhalt Ihrer API-Anmeldeinformationen

Suchen Sie nach der Anmeldung in Ihrem Dashboard nach dem Menü „Integrationen“, klicken Sie auf „Integration hinzufügen“ und wählen Sie den Typ „EduBase API“.

Wenn Sie diese Option nicht sehen, geben Sie den Aktivierungscode MCPGITHUB ein oder kontaktieren Sie uns, um Zugang anzufordern: [email protected].

Werkzeuge

Jeder dokumentierte API-Endpunkt ist als separates Werkzeug verfügbar, benannt edubase_<method>_<endpoint>. Zum Beispiel ist das Werkzeug für den Endpunkt GET /user:me benannt edubase_get_user_me. Weitere Informationen finden Sie in unserer Entwicklerdokumentation.

Konfiguration

Der MCP-Server kann über Umgebungsvariablen konfiguriert werden. Die folgenden Variablen sind verfügbar:

Variable	Beschreibung	Erforderlich	Standardwert
`EDUBASE_API_URL`	Die Basis-URL der EduBase-API, höchstwahrscheinlich `https://subdomain.edubase.net/api`.	Ja	`https://www.edubase.net/api`
`EDUBASE_API_APP`	Die App-ID Ihrer Integrations-App auf EduBase, die `app` in der EduBase-API. Finden Sie diese im Fenster mit den Integrationsdetails auf EduBase.	Nicht, wenn HTTP-Transport mit Authentifizierung verwendet wird, andernfalls Ja	-
`EDUBASE_API_KEY`	Der geheime Schlüssel Ihrer Integrations-App auf EduBase, der `secret` in der EduBase-API. Finden Sie diesen zusammen mit der App-ID im Fenster mit den Integrationsdetails auf EduBase.	Nicht, wenn HTTP-Transport mit Authentifizierung verwendet wird, andernfalls Ja	-
`EDUBASE_SSE_MODE`	Startet den MCP-Server im HTTP-Modus mit SSE-Transport. Der Wert muss `true` sein.	Nein	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	Startet den MCP-Server im HTTP-Modus mit streamfähigem HTTP-Transport. Der Wert muss `true` sein.	Nein	`false`
`EDUBASE_HTTP_PORT`	Der HTTP-Server lauscht auf diesem Port, wenn der SSE- oder streamfähige HTTP-Transportmodus verwendet wird.	Nein	3000
`EDUBASE_OAUTH`	Aktiviert das OAuth 2.1-Verhalten für geschützte Ressourcen: Nicht authentifizierte Anfragen werden mit `401 + WWW-Authenticate` abgelehnt, die auf `/.well-known/oauth-protected-resource` verweist, und Bearer-Token werden an die EduBase-API weitergeleitet.	Nein	`false`
`EDUBASE_OAUTH_AUTHORIZATION_SERVER`	Öffentliche Basis-URL der EduBase-Bereitstellung, die als OAuth-IdP fungiert. Wird verwendet, um den Autorisierungsserver im Metadatendokument der geschützten Ressource anzukündigen.	Nein	abgeleitet von `EDUBASE_API_URL`
`EDUBASE_OAUTH_RESOURCE_URL`	Öffentliche Basis-URL dieses MCP-Servers (der OAuth-Ressourcenindikator). Wird im `WWW-Authenticate`-Header und in den Ressourcenmetadaten verwendet.	Nein	abgeleitet von `EDUBASE_API_URL`

Verwendung als entfernter MCP-Server

Sie können den EduBase MCP-Server als entfernten MCP-Server für Ihren MCP-Client verwenden. Dazu müssen Sie den MCP-Server so hosten, dass Clients darauf zugreifen können, und dann den Client für die Verbindung mit dem Server konfigurieren. Starten Sie ihn entweder mit SSE- oder streamfähigem HTTP-Transportmodus und verwenden Sie immer HTTPS, wenn Sie aus der Ferne über das Internet auf den Server zugreifen!

Authentifizierung bei entfernten Servern

Sie können den Server in zwei Modi verwenden:

Ohne Client-Authentifizierung: In diesem Modus verlangt der Server keine Authentifizierung vom Client. Dies ist nützlich für Test- oder Entwicklungszwecke oder in einem geschlossenen Netzwerk, wird jedoch nicht für den Produktionseinsatz empfohlen. Dazu müssen Sie den Server auch mit EDUBASE_API_APP und EDUBASE_API_KEY konfigurieren!
Mit Bearer-Token-Authentifizierung: In diesem Modus verlangt der Server, dass mit jeder Anfrage ein Bearer-Token gesendet wird. Dies ist die empfohlene Methode für den Produktionseinsatz. Sie können das Bearer-Token von Ihrem EduBase-Konto erhalten, indem Sie eine Integrations-App erstellen und die App-ID und den geheimen Schlüssel im Format {app}:{secret} bereitstellen, base64-codiert als Token. Der Server verwendet dieses Token dann, um den Client zu authentifizieren und den Zugriff auf die API-Endpunkte zu autorisieren.
Mit OAuth 2.1 (EduBase als IdP): Wenn EDUBASE_OAUTH=true, entdecken kompatible Clients (Claude Desktop, Claude.ai-Konnektoren, Cursor, ChatGPT-Konnektoren usw.) den EduBase-Autorisierungsserver über /.well-known/oauth-protected-resource, registrieren sich dynamisch selbst (RFC 7591), führen den Benutzer durch einen EduBase-Zustimmungsbildschirm und tauschen einen Autorisierungscode (mit PKCE S256) gegen ein undurchsichtiges Zugriffstoken aus. Der MCP-Server leitet dieses Token unverändert an die EduBase-API weiter, die es in die automatisch bereitgestellte MCP-Integration auflöst, die bei der ersten Zustimmung erstellt wurde. Kein Kopieren von App-ID/Secret – Benutzer klicken einfach in ihrem Client auf „EduBase verbinden“.

Verwendung mit Claude Desktop

Eine schrittweise Anleitung finden Sie in unserem Blogbeitrag zur Verbindung von EduBase mit Claude: Der vollständige MCP-Integrationsleitfaden.

Verwendung des bereitgestellten EduBase MCP-Servers

Sie können den bereitgestellten EduBase MCP-Server (falls verfügbar) ohne jegliche Konfiguration verwenden, indem Sie ihn einfach als entfernten Server in Ihrem Client mit der URL https://domain.edubase.net/mcp hinzufügen (ersetzen Sie diese durch die tatsächliche Domain), wenn er OAuth-Authentifizierung unterstützt, oder mit dem entsprechenden Bearer-Token im Authorization-Header (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Empfohlen für Benutzer von www.edubase.net, da der Server von uns gewartet und aktualisiert wird und Sie sich nicht um Hosting oder Konfiguration kümmern müssen. Stellen Sie nur sicher, dass Sie die richtige URL und Authentifizierungsmethode verwenden, wenn Sie Ihren Client verbinden.

Manuelle Installation

Fügen Sie Folgendes zu Ihrer claude_desktop_config.json hinzu:

Verwendung von Node.js

Stellen Sie vor dem Ausführen des MCP-Servers sicher, dass Node.js installiert ist. Sie können es von nodejs.org herunterladen oder einen Paketmanager wie brew verwenden.

{
  "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"
      }
    }
  }
}

Oder laden Sie die EduBase MCP-Server-Version herunter oder klonen Sie das Repository und führen Sie npm run build aus, um den Server zu erstellen. Vergessen Sie nicht, /path/to/dist an das tatsächliche Verzeichnis anzupassen und die Umgebungsvariablen zu konfigurieren!

{
  "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"
      }
    }
  }
}

Verwendung von Docker

Stellen Sie vor dem Ausführen des MCP-Servers sicher, dass Docker installiert ist und ausgeführt wird. Sie können es von docker.com herunterladen oder einen Paketmanager verwenden. Vergessen Sie nicht, die Umgebungsvariablen zu konfigurieren!

{
  "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 über entfernten MCP-Server

Sie können den bereitgestellten EduBase MCP-Server (falls verfügbar) als entfernten Server verwenden. Wir empfehlen, Ihre EDUBASE_API_APP und EDUBASE_API_KEY Base64 zu codieren und sie als Bearer-Token im Authorization-Header (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) zu verwenden.

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

Installation über Smithery

So installieren Sie den EduBase MCP-Server für Claude Desktop automatisch über Smithery:

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

Kontakt

Website: www.edubase.net
Entwicklerdokumentation: developer.edubase.net
E-Mail: [email protected]