主控节点

Name: 主控节点
Author: EduBase

作者：EduBase22 星标更新：2025-10-22

项目介绍

EduBase MCP服务器

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

EduBase MCP演示GIF：Claude上传数学问题

什么是EduBase？

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

为什么选择EduBase？

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

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

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

演示视频

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

获取您的API凭证

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

如果您看不到这个选项，请输入MCPGITHUB激活码或联系我们请求访问权限 info@edubase.net。

工具

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

配置

MCP服务器可以通过环境变量进行配置。可用的变量如下：

变量	描述	必需	默认值
`EDUBASE_API_URL`	EduBase API的基本URL，可能是`https://子域.edubase.net/api`。	是	`https://www.edubase.net/api`
`EDUBASE_API_APP`	EduBase上集成应用的App ID，即EduBase API中的`app`。在EduBase的集成详情窗口中找到。	如果使用带认证的HTTP传输则不需要，否则需要	-
`EDUBASE_API_KEY`	EduBase上集成应用的Secret key，即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

用作远程MCP服务器

您可以将EduBase MCP服务器用作远程MCP服务器，供您的MCP客户端使用。为此，您需要在客户端可以访问的地方托管MCP服务器，然后配置客户端连接到服务器。启动时可以选择SSE或可流式传输的HTTP传输模式，并且在互联网上远程访问服务器时始终使用HTTPS！

远程服务器的身份验证

您可以使用两种模式：

无客户端身份验证：在这种模式下，服务器不会要求客户端进行任何身份验证。这对于测试或开发目的非常有用，或者在封闭网络中使用，但不建议在生产环境中使用。对于这种情况，您还需要配置EDUBASE_API_APP和EDUBASE_API_KEY！
带有Bearer令牌的身份验证：在这种模式下，服务器将要求每次请求都发送一个Bearer令牌。这是推荐的方式，在生产环境中使用服务器。您可以在EduBase账户中创建一个集成应用，并以{app}:{secret}格式提供App ID和Secret key，base64编码为令牌。然后，服务器将使用此令牌对客户端进行身份验证并授权访问API端点。

与Claude Desktop的使用

要了解详细步骤，请参阅我们关于如何连接EduBase与Claude：完整的MCP集成指南的博客文章。

手动安装

在claude_desktop_config.json中添加以下内容：

使用Node.js

在运行MCP服务器之前，请确保已安装Node.js。可以从nodejs.org下载，或使用包管理器如brew。下载EduBase MCP服务器发布版本或克隆仓库并运行npm run build来构建服务器。不要忘记调整/path/to/dist到实际目录，并配置环境变量！

{
  "mcpServers": {
    "edubase": {
      "command": "node",
      "args": [
        "/path/to/dist/index.js"
      ],
      "env": {
        "EDUBASE_API_URL": "https://域名.edubase.net/api",
        "EDUBASE_API_APP": "您的集成应用ID",
        "EDUBASE_API_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://域名.edubase.net/api",
        "EDUBASE_API_APP": "您的集成应用ID",
        "EDUBASE_API_KEY": "您的集成密钥"
      }
    }
  }
}

通过远程MCP服务器安装

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

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://域名.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
电子邮件：info@edubase.net