← 返回目录
E

EduBase MCP Server

官方
通过 MCP 让 LLM 操作 EduBase 在线教育平台
GitHub 源仓库 ↗
★ 27 Stars 分类 · 其他 热门
62FMRS · C

由 EduBase 官方维护的 MCP 服务器,将其在线教育平台的全部文档化 API 端点暴露给 LLM,支持多种传输方式与 OAuth 2.1 认证,安装方式丰富(npm/Docker/Smithery/托管远程),适合已采用 EduBase 的教育与企业场景。

可靠性
9/20
安全与权限
12/20
维护活跃度
13/20
文档质量
15/20
安装易用性
13/20
查看 FMRS 评分方法 →

EduBase MCP 服务器实现了模型上下文协议(MCP),让 Claude 等 LLM 与 EduBase 综合在线教育平台交互,可代用户执行账户操作。支持 stdio、SSE 和 streamable HTTP 传输协议,可通过 npm、Docker、Smithery 安装,也可使用官方托管的远程服务器。认证支持 Bearer 令牌及 OAuth 2.1(以 EduBase 作为身份提供方)。每个已文档化的 API 端点都作为独立工具提供,命名为 edubase_<方法>_<端点>。

工具能力

edubase_get_user_me
调用 GET /user:me 端点,获取当前用户信息。
edubase_filebin
文件上传工具,内置 SSRF 防护,阻止对私有及保留地址的请求。

安装接入

  1. 在 EduBase 仪表盘的 Integrations 菜单中添加类型为 "EduBase API" 的集成,获取 App ID 和 Secret(如不可见可使用激活码 MCPGITHUB 或联系 [email protected])。2. 使用 npx -y @edubase/mcp(npm 包 @edubase/mcp)、Docker 镜像 edubase/mcp,或 npx -y @smithery/cli install @EduBase/MCP --client claude 安装。3. 配置环境变量 EDUBASE_API_URL、EDUBASE_API_APP、EDUBASE_API_KEY。也可直接将客户端连接到远程 MCP 服务器 https://www.edubase.net/mcp,使用 Bearer 令牌或 OAuth。
claude_desktop_config.json
{"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"}}}}

选型与风险

适合谁

  • 已使用或计划使用 EduBase 平台的教育机构和企业培训团队
  • 希望让 LLM 管理 EduBase 账户内容(题目、考试、用户数据)的教师与课程管理员
  • 需要远程 MCP 服务器并支持 OAuth 2.1 认证的用户

不适合谁

  • 不使用 EduBase 平台的用户
  • 希望连接任意 LMS 或泛用学习工具的用户(本服务器仅对接 EduBase API)

所需权限

  • 需要 EduBase 集成应用的 App ID 和 Secret Key(EDUBASE_API_APP、EDUBASE_API_KEY)
  • 远程部署时客户端通过 Bearer 令牌(base64 编码的 app:secret)或 OAuth 2.1 访问
  • 本地 stdio 模式下需配置 API 凭据环境变量

风险与副作用

  • API Secret 泄露将导致他人可操作您的 EduBase 账户
  • LLM 可代为执行账户操作,误操作可能影响真实课程与考试数据
  • HTTP 传输模式暴露在公网时若未启用认证存在滥用风险
  • edubase_filebin 工具在自托管私有网络需谨慎配置 EDUBASE_ALLOW_PRIVATE_NETWORK

常见排障

  1. 确认已在 EduBase Integrations 页面创建 "EduBase API" 类型集成并获取 App ID 与 Secret
  2. 检查 EDUBASE_API_URL 是否指向正确的子域(默认 https://www.edubase.net/api)
  3. 远程连接时验证 Bearer 令牌为 base64 编码的 {app}:{secret} 格式
  4. 若 HTTP 模式无法启动,确认 EDUBASE_SSE_MODE 或 EDUBASE_STREAMABLE_HTTP_MODE 设为 true 并检查 EDUBASE_HTTP_PORT(默认 3000)
  5. OAuth 连接失败时确认 EDUBASE_OAUTH=true 并检查 /.well-known/oauth-protected-resource 元数据端点

使用场景

通过 Claude 创建并上传测验题目
安排考试并分析用户成绩
将现有内容转化为互动测验

支持客户端

Claude Desktop完整支持
Cursor部分支持
ChatGPT connectors部分支持
Claude.ai connectors部分支持