EduBase MCP Server

chính thức

Tương tác với EduBase, một nền tảng học tập điện tử toàn diện với các khả năng quản lý bài kiểm tra, kỳ thi và tổ chức nội dung nâng cao

GitHub

Tài liệu

Máy chủ MCP EduBase

Kho lưu trữ này chứa bản triển khai Giao thức Ngữ cảnh Mô hình (MCP) máy chủ dành cho nền tảng EduBase. Nó cho phép các máy khách MCP (ví dụ: Claude Desktop) và các LLM tương tác với tài khoản EduBase của bạn và thực hiện các tác vụ thay mặt bạn. Nó hỗ trợ các giao thức truyền tải stdio, SSE và HTTP có thể truyền phát.

EduBase MCP demo GIF: Claude uploads math questions

EduBase là gì?

EduBase là một nền tảng giáo dục trực tuyến sáng tạo, mô-đun, giúp việc học trở nên thú vị, đơn giản và tương tác hơn, phù hợp cho các tổ chức giáo dục hoặc doanh nghiệp.

Tại sao chọn EduBase?

EduBase cách mạng hóa việc học kỹ thuật số với sự kết hợp độc đáo các tính năng:

Hệ thống Câu hỏi Nâng cao với tham số hóa cho phép tạo ra vô số biến thể của cùng một câu hỏi, phát hiện gian lận theo thời gian thực, trình bày LaTeX đẹp mắt, hỗ trợ STEM nâng cao và chấm điểm tự động
Môi trường Học tập Thống nhất tập trung tất cả nội dung giáo dục của bạn — video, bài kiểm tra, tài liệu và các mô-đun SCORM — trong một hệ thống trực quan duy nhất
Bảo mật Cấp Doanh nghiệp với các tính năng như tích hợp SSO, kiểm soát truy cập chi tiết, kiểm toán toàn diện và tuân thủ GDPR
Tích hợp với các hệ thống hiện có của bạn thông qua LTI, API toàn diện và các tùy chọn tích hợp tùy chỉnh
Công cụ Hỗ trợ AI, chẳng hạn như Trợ lý EduBase, có thể ngay lập tức chuyển đổi nội dung hiện có của bạn thành các câu hỏi và bài đánh giá tương tác, hoặc dịch tài liệu của bạn từ ngôn ngữ này sang ngôn ngữ khác

Từ các cơ sở giáo dục đại học đến các bộ phận đào tạo doanh nghiệp, EduBase mở rộng quy mô để đáp ứng nhu cầu cụ thể của bạn trong khi vẫn duy trì trải nghiệm người dùng trực quan trên mọi thiết bị.

Video demo

Cùng nhau tạo và tải lên câu hỏi, lên lịch kiểm tra và phân tích kết quả người dùng với Claude:

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

Lấy thông tin xác thực API của bạn

Sau khi đăng nhập, trên Bảng điều khiển của bạn, tìm menu Tích hợp, nhấp vào "thêm tích hợp" và chọn loại "EduBase API".

Nếu bạn không thấy tùy chọn này, hãy nhập mã kích hoạt MCPGITHUB hoặc liên hệ với chúng tôi để yêu cầu quyền truy cập tại [email protected].

Công cụ

Mỗi điểm cuối API được ghi lại đều có sẵn dưới dạng một công cụ riêng biệt, được đặt tên là edubase_<method>_<endpoint>. Ví dụ: công cụ cho điểm cuối GET /user:me được đặt tên là edubase_get_user_me. Xem tài liệu dành cho nhà phát triển của chúng tôi để biết thêm thông tin.

Cấu hình

Máy chủ MCP có thể được cấu hình bằng các biến môi trường. Các biến sau đây có sẵn:

Biến	Mô tả	Bắt buộc	Giá trị mặc định
`EDUBASE_API_URL`	URL cơ sở của API EduBase, rất có thể là `https://subdomain.edubase.net/api`.	Có	`https://www.edubase.net/api`
`EDUBASE_API_APP`	ID Ứng dụng của ứng dụng tích hợp của bạn trên EduBase, `app` trên API EduBase. Tìm thông tin này trong cửa sổ chi tiết tích hợp trên EduBase.	Không nếu sử dụng truyền tải HTTP với xác thực, nếu không thì Có	-
`EDUBASE_API_KEY`	Khóa Bí mật của ứng dụng tích hợp của bạn trên EduBase, `secret` trên API EduBase. Tìm thông tin này cùng với ID Ứng dụng trong cửa sổ chi tiết tích hợp trên EduBase.	Không nếu sử dụng truyền tải HTTP với xác thực, nếu không thì Có	-
`EDUBASE_SSE_MODE`	Khởi động máy chủ MCP ở chế độ HTTP với truyền tải SSE. Giá trị phải là `true`.	Không	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	Khởi động máy chủ MCP ở chế độ HTTP với truyền tải HTTP có thể truyền phát. Giá trị phải là `true`.	Không	`false`
`EDUBASE_HTTP_PORT`	Máy chủ HTTP sẽ lắng nghe trên cổng này nếu sử dụng chế độ truyền tải SSE hoặc HTTP có thể truyền phát.	Không	3000
`EDUBASE_OAUTH`	Bật hành vi tài nguyên được bảo vệ OAuth 2.1: các yêu cầu không xác thực bị từ chối với `401 + WWW-Authenticate` trỏ đến `/.well-known/oauth-protected-resource`, và mã thông báo bearer được chuyển tiếp đến API EduBase.	Không	`false`
`EDUBASE_OAUTH_AUTHORIZATION_SERVER`	URL cơ sở công khai của triển khai EduBase hoạt động như IdP OAuth. Được sử dụng để quảng bá máy chủ ủy quyền trong tài liệu siêu dữ liệu tài nguyên được bảo vệ.	Không	được suy ra từ `EDUBASE_API_URL`
`EDUBASE_OAUTH_RESOURCE_URL`	URL cơ sở công khai của máy chủ MCP này (chỉ báo tài nguyên OAuth). Được sử dụng trong tiêu đề `WWW-Authenticate` và siêu dữ liệu tài nguyên.	Không	được suy ra từ `EDUBASE_API_URL`

Sử dụng như một máy chủ MCP từ xa

Bạn có thể sử dụng máy chủ MCP EduBase như một máy chủ MCP từ xa cho máy khách MCP của mình. Để làm điều này, bạn cần lưu trữ máy chủ MCP ở nơi máy khách có thể truy cập, sau đó cấu hình máy khách để kết nối với máy chủ. Hoặc khởi động nó với chế độ truyền tải SSE hoặc HTTP có thể truyền phát và luôn sử dụng HTTPS khi truy cập máy chủ từ xa qua internet!

Xác thực với máy chủ từ xa

Bạn có thể sử dụng máy chủ ở hai chế độ:

Không có xác thực máy khách: Ở chế độ này, máy chủ sẽ không yêu cầu bất kỳ xác thực nào từ máy khách. Điều này hữu ích cho mục đích thử nghiệm hoặc phát triển, hoặc trong mạng kín nhưng không được khuyến nghị cho sử dụng sản xuất. Đối với điều này, bạn cũng phải cấu hình máy chủ với EDUBASE_API_APP và EDUBASE_API_KEY!
Với xác thực mã thông báo Bearer: Ở chế độ này, máy chủ sẽ yêu cầu gửi mã thông báo Bearer cùng với mỗi yêu cầu. Đây là cách được khuyến nghị để sử dụng máy chủ trong sản xuất. Bạn có thể lấy mã thông báo Bearer từ tài khoản EduBase của mình bằng cách tạo một ứng dụng tích hợp và cung cấp ID Ứng dụng và Khóa Bí mật ở định dạng {app}:{secret}, được mã hóa base64 thành mã thông báo. Sau đó, máy chủ sẽ sử dụng mã thông báo này để xác thực máy khách và ủy quyền truy cập vào các điểm cuối API.
Với OAuth 2.1 (EduBase làm IdP): Khi EDUBASE_OAUTH=true, các máy khách tương thích (Claude Desktop, trình kết nối Claude.ai, Cursor, trình kết nối ChatGPT, v.v.) khám phá máy chủ ủy quyền EduBase thông qua /.well-known/oauth-protected-resource, tự đăng ký động (RFC 7591), hướng dẫn người dùng qua màn hình đồng ý của EduBase và trao đổi mã ủy quyền (với PKCE S256) để lấy mã thông báo truy cập không trong suốt. Máy chủ MCP chuyển tiếp nguyên văn mã thông báo đó đến API EduBase, API này sẽ phân giải nó thành tích hợp MCP được tự động cung cấp, được tạo ra khi đồng ý lần đầu. Không cần sao chép ID Ứng dụng/Bí mật — người dùng chỉ cần nhấp vào "Kết nối EduBase" trong máy khách của họ.

Sử dụng với Claude Desktop

Để có hướng dẫn từng bước, hãy xem bài đăng trên blog của chúng tôi về cách kết nối EduBase với Claude: Hướng dẫn Tích hợp MCP Toàn diện.

Sử dụng máy chủ MCP EduBase được cung cấp

Bạn có thể sử dụng máy chủ MCP EduBase được cung cấp (nếu có) mà không cần bất kỳ cấu hình nào, chỉ bằng cách thêm nó làm máy chủ từ xa trong máy khách của bạn với URL https://domain.edubase.net/mcp (thay thế bằng tên miền thực tế), nếu nó hỗ trợ xác thực OAuth, hoặc với mã thông báo Bearer thích hợp trong tiêu đề Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Được khuyến nghị cho người dùng www.edubase.net, vì máy chủ được chúng tôi duy trì và cập nhật, và bạn không phải lo lắng về việc lưu trữ hoặc cấu hình nó. Chỉ cần đảm bảo sử dụng đúng URL và phương thức xác thực khi kết nối máy khách của bạn.

Cài đặt thủ công

Thêm phần sau vào claude_desktop_config.json của bạn:

Sử dụng Node.js

Trước khi chạy máy chủ MCP, hãy đảm bảo bạn đã cài đặt Node.js. Bạn có thể tải xuống từ nodejs.org hoặc sử dụng trình quản lý gói như 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"
      }
    }
  }
}

Hoặc tải xuống bản phát hành máy chủ MCP EduBase hoặc sao chép kho lưu trữ và chạy npm run build để xây dựng máy chủ. Đừng quên điều chỉnh /path/to/dist thành thư mục thực tế và cấu hình các biến môi trường!

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

Sử dụng Docker

Trước khi chạy máy chủ MCP, hãy đảm bảo bạn đã cài đặt Docker và nó đang chạy. Bạn có thể tải xuống từ docker.com hoặc sử dụng trình quản lý gói. Đừng quên cấu hình các biến môi trường!

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

Cài đặt qua máy chủ MCP từ xa

Bạn có thể sử dụng máy chủ MCP EduBase được cung cấp (nếu có) như một máy chủ từ xa. Chúng tôi khuyên bạn nên mã hóa Base64 EDUBASE_API_APP và EDUBASE_API_KEY của bạn và sử dụng nó làm mã thông báo Bearer trong tiêu đề Authorization (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}"
      ]
    }
  }
}

Cài đặt qua Smithery

Để cài đặt máy chủ MCP EduBase cho Claude Desktop tự động qua Smithery:

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

Liên hệ

Trang web: www.edubase.net
Tài liệu cho Nhà phát triển: developer.edubase.net
Email: [email protected]