EduBase MCP Server

官方

与EduBase交互，这是一个全面的电子学习平台，具备高级测验、考试管理和内容组织功能

文档

EduBase MCP 服务器

此仓库包含为 EduBase 平台实现的模型上下文协议（MCP）服务器。它允许 MCP 客户端（例如 Claude Desktop）和 LLM 与您的 EduBase 账户交互，并代表您执行任务。它支持 stdio、SSE 和可流式传输的 HTTP 传输协议。

EduBase MCP demo GIF: Claude uploads math questions

什么是 EduBase？

EduBase 是一个创新、模块化的在线教育平台，让学习更愉快、更简单、更具互动性，适用于教育机构或企业。

为什么选择 EduBase？

EduBase 以其独特的功能组合革新了数字学习：

高级测验系统，支持参数化，可生成同一问题的无限变体，具备实时作弊检测、精美的 LaTeX 排版、高级 STEM 支持和自动评分功能
统一学习环境，将所有教育内容——视频、考试、文档和 SCORM 模块——集中在一个直观的系统中
企业级安全，具备 SSO 集成、细粒度访问控制、全面审计和 GDPR 合规等功能
集成，通过 LTI、全面的 API 和自定义集成选项与您现有的系统对接
AI 辅助工具，如 EduBase 助手，可以即时将您现有的内容转换为互动测验和评估，或将您的材料从一种语言翻译成另一种语言

从高等教育机构到企业培训部门，EduBase 可根据您的特定需求进行扩展，同时在所有设备上保持直观的用户体验。

演示视频

使用 Claude 协作创建和上传问题、安排考试并分析用户结果：

Demonstrating EduBase's MCP server to collaboratively create and upload questions, schedule exams and analyze results.

获取您的 API 凭据

登录后，在您的仪表板上，找到“集成”菜单，点击“添加集成”，然后选择“EduBase API”类型。

如果您没有看到此选项，请输入 MCPGITHUB 激活码，或随时通过 [email protected] 联系我们以请求访问权限。

工具

每个已记录的 API 端点都作为一个单独的工具提供，命名为 edubase_<method>_<endpoint>。例如，GET /user:me 端点的工具命名为 edubase_get_user_me。有关更多信息，请参阅我们的开发者文档。

配置

MCP 服务器可以使用环境变量进行配置。以下变量可用：

变量	描述	是否必需	默认值
`EDUBASE_API_URL`	EduBase API 的基础 URL，很可能是 `https://subdomain.edubase.net/api`。	是	`https://www.edubase.net/api`
`EDUBASE_API_APP`	您在 EduBase 上的集成应用的 App ID，即 EduBase API 上的 `app`。可在 EduBase 的集成详情窗口中找到。	如果使用 HTTP 传输且进行身份验证，则不需要，否则是	-
`EDUBASE_API_KEY`	您在 EduBase 上的集成应用的 Secret 密钥，即 EduBase API 上的 `secret`。可在 EduBase 的集成详情窗口中与 App ID 一起找到。	如果使用 HTTP 传输且进行身份验证，则不需要，否则是	-
`EDUBASE_SSE_MODE`	以 HTTP 模式启动 MCP 服务器，使用 SSE 传输。值必须为 `true`。	否	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	以 HTTP 模式启动 MCP 服务器，使用可流式传输的 HTTP 传输。值必须为 `true`。	否	`false`
`EDUBASE_HTTP_PORT`	如果使用 SSE 或可流式传输的 HTTP 传输模式，HTTP 服务器将监听此端口。	否	3000
`EDUBASE_OAUTH`	启用 OAuth 2.1 受保护资源行为：未经身份验证的请求将被拒绝，并返回 `401 + WWW-Authenticate`，指向 `/.well-known/oauth-protected-resource`，并且 Bearer 令牌将转发到 EduBase API。	否	`false`
`EDUBASE_OAUTH_AUTHORIZATION_SERVER`	作为 OAuth IdP 的 EduBase 部署的公共基础 URL。用于在受保护资源元数据文档中公布授权服务器。	否	从 `EDUBASE_API_URL` 派生
`EDUBASE_OAUTH_RESOURCE_URL`	此 MCP 服务器（OAuth 资源指示器）的公共基础 URL。用于 `WWW-Authenticate` 标头和资源元数据。	否	从 `EDUBASE_API_URL` 派生

作为远程 MCP 服务器使用

您可以将 EduBase MCP 服务器作为远程 MCP 服务器用于您的 MCP 客户端。为此，您需要将 MCP 服务器托管在客户端可以访问的位置，然后配置客户端连接到该服务器。可以使用 SSE 或可流式传输的 HTTP 传输模式启动它，并且在通过互联网远程访问服务器时，务必使用 HTTPS！

远程服务器的身份验证

您可以在两种模式下使用服务器：

无客户端身份验证：在此模式下，服务器不需要客户端的任何身份验证。这对于测试或开发目的，或在封闭网络中很有用，但不建议用于生产环境。为此，您还必须使用 EDUBASE_API_APP 和 EDUBASE_API_KEY 配置服务器！
使用 Bearer 令牌身份验证：在此模式下，服务器要求每个请求都发送一个 Bearer 令牌。这是在生产环境中使用服务器的推荐方式。您可以通过创建集成应用，并以 {app}:{secret} 格式提供 App ID 和 Secret 密钥（进行 base64 编码作为令牌），从您的 EduBase 账户获取 Bearer 令牌。然后，服务器将使用此令牌对客户端进行身份验证，并授权访问 API 端点。
使用 OAuth 2.1（EduBase 作为 IdP）：当 EDUBASE_OAUTH=true 时，兼容的客户端（Claude Desktop、Claude.ai 连接器、Cursor、ChatGPT 连接器等）通过 /.well-known/oauth-protected-resource 发现 EduBase 授权服务器，动态注册自身（RFC 7591），引导用户完成 EduBase 同意屏幕，并将授权码（使用 PKCE S256）交换为不透明访问令牌。MCP 服务器将该令牌原样转发到 EduBase API，后者将其解析为在首次同意时创建的自动配置的 MCP 集成。无需复制 App ID/Secret——用户只需在其客户端中点击“连接 EduBase”。

与 Claude Desktop 配合使用

有关分步指南，请参阅我们的博客文章，了解如何将 EduBase 与 Claude 连接：完整的 MCP 集成指南。

使用提供的 EduBase MCP 服务器

您可以使用提供的 EduBase MCP 服务器（如果可用），无需任何配置，只需将其作为远程服务器添加到您的客户端，URL 为 https://domain.edubase.net/mcp（替换为实际域名），如果它支持 OAuth 身份验证，或者在 Authorization 标头中使用适当的 Bearer 令牌（Authorization: Bearer ${BASE64_ENCODED_TOKEN}）。

推荐 www.edubase.net 用户使用，因为该服务器由我们维护和更新，您无需担心托管或配置问题。只需在连接客户端时确保使用正确的 URL 和身份验证方法。

手动安装

将以下内容添加到您的 claude_desktop_config.json：

使用 Node.js

在运行 MCP 服务器之前，请确保您已安装 Node.js。您可以从 nodejs.org 下载，或使用包管理器（如 brew）。

{
  "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 MCP 服务器发行版或克隆仓库，然后运行 npm run build 来构建服务器。不要忘记将 /path/to/dist 调整为实际目录，并配置环境变量！

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

使用 Docker

在运行 MCP 服务器之前，请确保您已安装 Docker 并且正在运行。您可以从 docker.com 下载，或使用包管理器。不要忘记配置环境变量！

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

通过远程 MCP 服务器安装

您可以使用提供的 EduBase MCP 服务器（如果可用）作为远程服务器。我们建议对您的 EDUBASE_API_APP 和 EDUBASE_API_KEY 进行 Base64 编码，并将其用作 Authorization 标头中的 Bearer 令牌（Authorization: Bearer ${BASE64_ENCODED_TOKEN}）。

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 EduBase MCP 服务器：

npx -y @smithery/cli install @EduBase/MCP --client claude

联系方式

网站：www.edubase.net
开发者文档：developer.edubase.net
电子邮件：[email protected]