EduBase MCP Server

官方

通过 MCP 让 LLM 操作 EduBase 在线教育平台

分类: 其他第 57 / 230
Stars: ★ 28 热门
传输方式: stdio（本地进程） · SSE · Streamable HTTP
运行环境: Node.js · Docker · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 4 天前
工具数: 2

62FMRS · C

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

最强项 · 文档质量 15/20 最弱项 · 可靠性 9/20

可靠性

9/20

安全与权限

12/20

维护活跃度

13/20

文档质量

15/20

安装易用性

13/20

查看各项评分依据

可靠性 9/20: 仅能看到 README 和 server.json 清单，未提供实际源码、测试文件或 CI 工作流内容（仅有徽章链接指向 pre-commit.ci 和 publish-mcp.yml，未展示具体测试覆盖）。工具通过'每个 API 端点对应一个工具'的命名规则批量生成（edubase_<method>_<endpoint>），声称与开发者文档一一对应，但无法静态验证工具声明与真实行为是否一致，也没有错误处理、边界情况或依赖控制的证据。版本号 1.2.16 暗示有一定迭代成熟度，但依据静态评审规则，在缺乏可验证的测试/CI证据时可靠性不应超过12分。
安全与权限 12/20: 密钥通过环境变量传递（EDUBASE_API_SECRET/EDUBASE_API_KEY 标记为 isSecret），README 示例中使用占位符而非真实凭据，未发现红线级问题。edubase_filebin 工具默认阻止对私有/环回/链路本地地址的出站请求（SSRF防护），并提供可选的主机白名单，这是积极信号。同时支持 OAuth 2.1 + PKCE，避免明文凭据暴露。但清单和文档均未说明各工具的最小权限范围或对不可逆操作（如删除内容、发布考试、修改成绩等教育平台常见破坏性操作）是否有二次确认机制，权限粒度似乎依赖 EduBase 后端的 App 级别授权而非工具级限定，属于'主要风险可见但权限/确认机制不完整'的中等水平。
维护活跃度 13/20: 仓库使用 MIT 许可证，配置了 GitHub Actions 自动发布到 MCP Registry 的工作流，并接入 pre-commit.ci，version 1.2.16 显示有持续版本迭代。Open issues 为 0，未归档（not archived），存在联系邮箱作为反馈渠道。但缺乏可见的提交历史、贡献者规模或安全响应流程的具体说明，星标数较少（27），难以判断社区活跃度和长期维护保障。
文档质量 15/20: README 内容详实，涵盖 npx/Node/Docker/Smithery 多种安装方式、完整的环境变量配置表、三种认证模式（无认证、Bearer令牌、OAuth 2.1）说明，以及远程/本地部署对比。工具命名规则有清晰说明并链接外部开发者文档。但仓库内文档未给出具体工具参数列表、速率限制、费用或详细故障排查章节，这些依赖外部链接（developer.edubase.net），存在'可用但排查信息不足'的缺口。
安装易用性 13/20: 提供多种安装路径（npx、本地构建、Docker、远程服务器、Smithery一键安装），并给出 claude_desktop_config.json 具体配置示例，步骤清晰。根据静态评审规则，由于没有实际执行验证的证据（无已提交测试或明确CI通过记录可查），安装易用性得分不得超过15分，故在'步骤清晰但依赖手动配置凭据、未经运行验证'的水平上评分。

静态评测 · 未实际运行收录于 2026-09-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已使用或计划使用 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

安装接入

准备工作

运行环境：Node.js · Docker · 远程托管（无需本地环境）

EDUBASE_API_APP 必填集成应用的 App ID，在 EduBase 集成详情窗口中获取，必填。

EDUBASE_API_KEY 必填密钥集成应用的 Secret key，与 App ID 同处获取，必填且为机密。

EDUBASE_API_SECRET 必填密钥服务器清单中定义的 API 密钥变量，机密、必填。

其他可选配置项（9 个）

EDUBASE_API_URL 可选 EduBase API 的基础地址，通常为 https://subdomain.edubase.net/api，默认 https://www.edubase.net/api。

EDUBASE_SSE_MODE 可选设为 true 时以 SSE 传输启动 HTTP 模式，默认 false。

EDUBASE_STREAMABLE_HTTP_MODE 可选设为 true 时以 streamable HTTP 传输启动 HTTP 模式，默认 false。

EDUBASE_HTTP_PORT 可选 HTTP 模式监听端口，默认 3000。

EDUBASE_OAUTH 可选设为 true 启用 OAuth 2.1 受保护资源行为。

EDUBASE_OAUTH_AUTHORIZATION_SERVER 可选作为 OAuth IdP 的 EduBase 部署的公开基础 URL。

EDUBASE_OAUTH_RESOURCE_URL 可选本 MCP 服务器的公开基础 URL（OAuth 资源标识）。

EDUBASE_ALLOW_PRIVATE_NETWORK 可选设为 true 允许 filebin 访问私有网络地址（默认阻止以防 SSRF）。

EDUBASE_FILEBIN_ALLOWED_HOSTS 可选逗号分隔的 filebin 上传目标主机白名单。

在 EduBase 仪表盘的 Integrations 菜单中添加类型为 "EduBase API" 的集成，获取 App ID 和 Secret（如不可见可使用激活码 MCPGITHUB 或联系 [email protected]）。
使用 npx -y @edubase/mcp（npm 包 @edubase/mcp）、Docker 镜像 edubase/mcp，或 npx -y @smithery/cli install @EduBase/MCP --client claude 安装。
配置环境变量 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"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add edubase -e EDUBASE_API_URL=https://domain.edubase.net/api -e EDUBASE_API_APP=your_integration_app_id -e EDUBASE_API_KEY=your_integration_secret_key -- npx -y @edubase/mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中应出现 edubase_get_user_me 等以 edubase_ 开头的工具；调用“我的账户信息”能返回你的 EduBase 用户数据即证明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查询我在 EduBase 账户中的个人信息
把这份文档通过 filebin 上传到 EduBase
列出我的账户资料并确认 API 连接正常

工具能力 2

edubase_get_user_me 只读

调用 GET /user:me 端点，获取当前用户信息。

edubase_filebin 写入

文件上传工具，内置 SSRF 防护，阻止对私有及保留地址的请求。

使用场景

通过 Claude 创建并上传测验题目

安排考试并分析用户成绩

将现有内容转化为互动测验

支持客户端

Claude Desktop

Cursor部分支持

ChatGPT connectors部分支持

Claude.ai connectors部分支持

依据项目文档列出，未经本站实测。

详细介绍

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