EduBase MCP Server

官方

與EduBase互動，這是一個全面的電子學習平台，具備進階測驗、考試管理及內容組織功能。

文件

EduBase MCP 伺服器

此儲存庫包含為 EduBase 平台實作的模型上下文協定 (Model Context Protocol, 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`	以 SSE 傳輸的 HTTP 模式啟動 MCP 伺服器。值必須為 `true`。	否	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	以可串流 HTTP 傳輸的 HTTP 模式啟動 MCP 伺服器。值必須為 `true`。	否	`false`
`EDUBASE_HTTP_PORT`	如果使用 SSE 或可串流 HTTP 傳輸模式，HTTP 伺服器將監聽此連接埠。	否	3000
`EDUBASE_OAUTH`	啟用 OAuth 2.1 受保護資源行為：未經驗證的請求將被拒絕，並附上指向 `/.well-known/oauth-protected-resource` 的 `401 + WWW-Authenticate`，且 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]