EduBase

EduBase

EduBase MCP server enabling MCP clients and LLMs to manage EduBase accounts.

22
Stars
9
Forks
20
Releases

Overview

EduBase MCP server is the MCP implementation for the EduBase platform, enabling MCP clients (for example Claude Desktop) and LLMs to interact with a user’s EduBase account and perform tasks on their behalf. It supports stdio, SSE, and streamable HTTP transport protocols, providing flexible integration options across tooling environments. The server exposes every documented EduBase API endpoint as a separate MCP tool named edubase_<method>_<endpoint> (for example edubase_get_user_me), simplifying request construction and automation. Configuration is entirely environment-driven, with variables such as EDUBASE_API_URL, EDUBASE_API_APP, EDUBASE_API_KEY, EDUBASE_SSE_MODE, EDUBASE_STREAMABLE_HTTP_MODE, and EDUBASE_HTTP_PORT controlling connectivity and transport. You can run the server as a remote MCP server with or without client authentication; in the Bearer token mode, the token is derived from the App ID and Secret (base64-encoded) and supplied via the Authorization header. The project also provides installation paths (Node.js build, Docker, remote server, and Smithery) and guidance for Claude Desktop integration, along with links to developer docs and tutorials.

Details

Owner
EduBase
Language
TypeScript
License
MIT License
Updated
2025-12-07

Features

Transport protocol support

Supports stdio, SSE, and streamable HTTP transport protocols for MCP communications.

API endpoint tooling

Each EduBase API endpoint is exposed as a separate MCP tool named edubase_<method>_<endpoint>.

Environment-variable configuration

Configurable via EDUBASE_API_URL, EDUBASE_API_APP, EDUBASE_API_KEY, EDUBASE_SSE_MODE, EDUBASE_STREAMABLE_HTTP_MODE, and EDUBASE_HTTP_PORT.

Remote MCP server with flexible auth

Can be used as a remote MCP server with either without client authentication or Bearer token authentication.

Bearer token authentication flow

Bearer token is obtained by base64-encoding app:secret and used in the Authorization header.

Installation options

Manual Node.js build, Docker-based deployment, remote MCP server usage, and Smithery installation supported.

Claude Desktop integration

Provides guidance and demos for connecting EduBase with Claude Desktop.

Documentation and references

Links to developer docs and tutorials for setup and usage.

Audience

MCP clientsInteract with EduBase accounts and perform tasks on behalf of a user.
LLMsEnable LLMs to operate EduBase features through MCP-based requests, enhancing automation and integration.

Tags

MCP serverEduBaseEducation technologyQuizzesExamsAPI integrationClaudeRemote serverSSEStreamable HTTPBearer tokenEnvironment variables