EduBase MCP 服务器是 EduBase 平台基于 Model Context Protocol（MCP）的服务器实现，用于让 Claude 等 MCP 客户端与大语言模型连接用户的 EduBase 账号并代为执行任务。EduBase 是一个模块化的在线教育平台，面向教育机构或企业，提供更具互动性的学习体验。
用途与主要能力 通过该 MCP 服务器，用户可以借助 Claude 等客户端协作创建和上传题目、安排考试并分析用户结果。EduBase 平台自身具备以下能力：参数化高级测验系统，同一道题可产生无限变体；实时作弊检测；LaTeX 排版；高级 STEM 支持；自动评分；统一学习环境，集中管理视频、考试、文档和 SCORM 模块；企业级安全，包括 SSO 集成、细粒度访问控制、全面审计和 GDPR 合规；通过 LTI、完整 API 和自定义集成选项对接现有系统；AI 辅助工具（如 EduBase Assistant）可将现有内容即时转换为互动测验与评估，或将材料在语言间翻译。
工具与工具集 每个有文档的 API 端点都被实现为一个工具，命名规则为 edubase_<method>_<endpoint>，例如 GET /user:me 对应工具 edubase_get_user_me。tag、permission 和 transfer 端点对每种内容类型行为一致，因此每种方法共用一个带 type 参数的工具，例如 edubase_post_content_tag 用于 POST /exam:tag、POST /quiz:tag 等。详细信息可参考其开发者文档。 工具按工具集分组，可以只暴露需要的工具。工具越少，模型上下文消耗越小，也更容易选对工具。每个工具集默认启用。通过 EDUBASE_TOOLSETS 以逗号分隔列出所需工具集（如 questions,quizzes,exams）。设置 EDUBASE_READONLY=true 只暴露读取数据的工具（get 类工具以及只生成下载链接的工具，如 edubase_post_question_export）。设置 EDUBASE_DYNAMIC_TOOLSETS=true 可按需启用工具集：会话开始时只加载关键工具，模型通过 edubase_enable_toolsets 工具启用所需工具集（可通过 edubase_list_toolsets 列出）。这能让初始工具列表保持精简，适合会预加载全部工具的客户端，但需要客户端在收到变更通知时刷新工具列表。 使用 HTTP 传输时，客户端可通过 EduBase-Mcp-Toolsets、EduBase-Mcp-ReadOnly 和 EduBase-Mcp-Dynamic 请求头，或 toolsets、read_only、dynamic_toolsets 查询参数，为自身会话进一步缩小配置，例如 https://domain.edubase.net/mcp?toolsets=exams&read_only=true。会话不能启用服务器配置所禁用的工具集或写入工具。
提示词与资源 提示词（Prompts）是可直接从 MCP 客户端（例如 + 或 / 菜单）启动的现成工作流。支持补全的客户端会在输入时提示参数取值：题型、以及用户自己的考试、Quiz 集和班级。提示词仅在其对应工具集启用时才会提供，只读模式下只提供后两个。 当考试题型留空时，支持引导（elicitation）的客户端会以复选框询问题型。这些客户端也会在不可撤销的操作（删除考试、Quiz 集、题目、用户、组织与集成，转移所有权，开始新一轮考试，轮换集成密钥）执行前请求确认。设置 EDUBASE_ELICITATION=false 可关闭这些询问。 参考文档以资源形式提供，也可通过 edubase_mcp_reference 工具供无法读取资源的模型使用：edubase://reference/questions（题目字段与类型）和 edubase://reference/exam-journeys（可移植的考试旅程格式）。考试与 Quiz 集也可作为资源挂载（edubase://exam/{exam} 和 edubase://quiz/{quiz}），并列出与建议内容。可用 EDUBASE_CONTENT_RESOURCES=false 关闭，或在会话中通过 EduBase-Mcp-Content-Resources: false 请求头、content_resources=false 查询参数或 Smithery 的 edubaseContentResources 设置关闭。创建或修改考试、Quiz 集和旅程的工具会链接到它们在 EduBase 中的页面。 MCP 服务器可通过环境变量配置。
获取 API 凭证 登录后，在 Dashboard 中找到 Integrations 菜单，点击“add integration”并选择类型“EduBase API”。如果没有此选项，请输入激活码 MCPGITHUB，或通过 info@edubase.net 联系申请访问权限。
作为远程 MCP 服务器使用 可以将 EduBase MCP 服务器作为远程 MCP 服务器供你的 MCP 客户端使用。需要在客户端可访问的位置托管该服务器，然后配置客户端连接。启动时选择 SSE 或可流式 HTTP 传输模式，且通过互联网远程访问时务必使用 HTTPS。
远程服务器的认证 服务器支持两种模式：
- 无客户端认证：服务器不要求客户端认证。适用于测试或开发，或封闭网络，但不建议用于生产。此模式需同时配置 EDUBASE_API_APP 和 EDUBASE_API_KEY。
- Bearer 令牌认证：每个请求需携带 Bearer 令牌。这是生产环境推荐方式。在 EduBase 账号中创建一个集成应用，以 {app}:{secret} 格式提供 App ID 和 Secret key，并做 base64 编码作为令牌。服务器随后用该令牌认证客户端并授权访问 API 端点。
OAuth 2.1（EduBase 作为 IdP） 当 EDUBASE_OAUTH=true 时，兼容的客户端（Claude Desktop、Claude.ai connectors、Cursor、ChatGPT connectors 等）可通过 /.well-known/oauth-protected-resource 发现 EduBase 授权服务器，进行动态注册（RFC 7591），引导用户完成 EduBase 同意屏，并用 PKCE S256 交换授权码获得不透明访问令牌。MCP 服务器将该令牌原样转发给 EduBase API，由 API 解析为首次同意时自动创建的 MCP 集成。无需复制 App ID/Secret——用户只需在客户端点击“Connect EduBase”。
与 Claude Desktop 配合使用 分步指南可参见其博客文章《The Complete MCP Integration Guide》。
使用提供的 EduBase MCP 服务器 如果客户端支持 OAuth 认证，只需以 URL https://domain.edubase.net/mcp（替换为实际域名）添加为远程服务器即可，无需任何配置；或在 Authorization 头中携带合适的 Bearer 令牌（Authorization: Bearer ${BASE64_ENCODED_TOKEN}）。推荐 www.edubase.net 用户使用，因为该服务器由官方维护更新，无需自行托管或配置。连接客户端时确保使用正确的 URL 和认证方式即可。
手动安装 在 claude_desktop_config.json 中添加相应配置。运行 MCP 服务器前，确保已安装 Node.js，可从 nodejs.org 下载或使用 brew 等包管理器。也可下载 EduBase MCP 服务器发布版或克隆仓库并运行 npm run build 构建服务器。注意将 /path/to/dist 调整为实际目录，并配置环境变量。使用 Docker 前，确保已安装并运行 Docker，可从 docker.com 下载或使用包管理器，并注意配置环境变量。
通过远程 MCP 服务器安装 可将提供的 EduBase MCP 服务器（如可用）作为远程服务器使用。建议将 EDUBASE_API_APP 和 EDUBASE_API_KEY 进行 Base64 编码后，作为 Authorization 头中的 Bearer 令牌使用（Authorization: Bearer ${BASE64_ENCODED_TOKEN}）。
通过 Smithery 安装 可通过 Smithery 为 Claude Desktop 自动安装 EduBase MCP 服务器。
测试与参考文档维护 运行 npm test 可构建服务器并检查工具列表：工具列表与服务器指令的大小预算、工具描述、工具集、只读与动态工具集模式，以及 HTTP 传输的配置处理。当新工具超出预算时，需精简其 schema 或在 test/server.test.mjs 中有意提高预算，因为每个客户端在每个会话中都要为工具列表付出代价。src/references 中的参考文档由 EduBase 开发者文档生成，当题目字段或考试旅程格式变化时，用 node scripts/sync-references.mjs <path to the developer documentation repository> 重新生成。
适用场景 适用于教育机构或企业培训部门，需要借助 Claude 等 LLM 在 EduBase 上协作出题、上传题目、安排考试和分析成绩的场景；需要将 EduBase 与现有系统集成，或通过远程 MCP 服务器、Bearer 令牌、OAuth 2.1 等方式安全接入 AI 客户端的场景。
限制 关于该 MCP 服务器的具体收费、价格、可用平台等事实暂未提供。工具集、只读模式、动态工具集、提示词与资源等行为受服务器配置与客户端能力约束：会话不能启用服务器配置禁用的工具集或写入工具；只读模式下只提供部分提示词；动态工具集需要客户端在收到变更通知时刷新工具列表；提示词补全、引导确认等依赖客户端能力。远程访问必须使用 HTTPS。更多细节以官方文档为准。
