EduBase

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 streamable HTTP.

Was ist EduBase?

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

Warum EduBase wählen?

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, schönem 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 Assistant, 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 Weiterbildungsabteilungen 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:

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: info@edubase.net.

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, sonst 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, sonst 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 streamable HTTP-Transport. Der Wert muss true sein.	Nein	false
EDUBASE_HTTP_PORT	Der HTTP-Server lauscht auf diesem Port, wenn der SSE- oder streamable 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 anzugeben.	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
EDUBASE_ALLOW_PRIVATE_NETWORK	Wenn ein HTTP-Transport verwendet wird, blockiert das Werkzeug edubase_filebin ausgehende Anfragen an private, Loopback-, Link-Local- und reservierte Adressen (SSRF-Schutz) und verweigert lokale Dateipfade. Setzen Sie auf true, um sie zu erlauben, z. B. bei einer selbst gehosteten Bereitstellung in einem vertrauenswürdigen privaten Netzwerk. Hat keine Auswirkung im stdio-Modus, wo der lokale Benutzer der einzige Aufrufer ist.	Nein	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	Optionale, durch Kommas getrennte Zulassungsliste von Hostnamen, die als edubase_filebin-Upload-Ziele erlaubt sind (exakter Host oder jede Subdomain, z. B. edubase.net). Wenn leer, ist jeder öffentliche Host erlaubt (vorbehaltlich der oben genannten Adressfilterung).	Nein	-

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 im SSE- oder streamable HTTP-Transportmodus und verwenden Sie immer HTTPS, wenn Sie aus der Ferne über das Internet auf den Server zugreifen!

Authentifizierung mit entfernten Servern

Sie können den Server in zwei Modi verwenden:

• Ohne Client-Authentifizierung: In diesem Modus benötigt 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. Dafür müssen Sie den Server auch mit EDUBASE_API_APP und EDUBASE_API_KEY konfigurieren!
• Mit Bearer-Token-Authentifizierung: In diesem Modus erfordert 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 opakes 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 wird. 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 (ersetzen Sie diese durch die tatsächliche Domain) hinzufügen, 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 das Hosting oder die 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 Ihren 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: info@edubase.net