EduBase
chính thứcTươ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
Bạn có thể làm gì với EduBase MCP?
- Tạo và xuất bản câu hỏi — Yêu cầu trợ lý viết câu hỏi mới và xuất bản lên QuestionBase của bạn thông qua
edubase_prompt_create_question. - Chuyển tài liệu thành câu hỏi — Chuyển tài liệu đính kèm, đường dẫn tệp hoặc URL thành câu hỏi sau khi phê duyệt kế hoạch, đồng thời có thể thêm chúng vào bộ Quiz.
- Tạo bài thi theo chủ đề — Tạo câu hỏi về một chủ đề, tập hợp chúng vào bộ Quiz và tạo bài thi theo lịch bằng
edubase_prompt_create_exam. - Tóm tắt kết quả bài thi — Phân tích kết quả bài thi và có thể lưu bản tóm tắt vào bài thi bằng
edubase_prompt_summarize_exam_results. - Giao bài thi cho lớp — Giao bài thi cho các thành viên đang hoạt động của một lớp bằng
edubase_prompt_assign_class_to_exam. - Kiểm tra tiến độ hành trình thi — Xem người dùng đang tiến triển như thế nào trong hành trình thi và ai đang bị mắc kẹt thông qua
edubase_prompt_exam_journey_status.
Tài liệu
Máy chủ MCP EduBase
Kho lưu trữ này chứa phần triển khai Model Context Protocol (MCP) của máy chủ dành cho nền tảng EduBase. Máy chủ cho phép các ứng dụng khách MCP (ví dụ: Claude Desktop) và 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 bạn. Máy chủ hỗ trợ các giao thức truyền tải stdio, SSE và HTTP có thể truyền luồng.

EduBase là gì?
EduBase là một nền tảng giáo dục trực tuyến, mô-đun và sáng tạo, giúp việc học trở nên thú vị, đơn giản và tương tác hơn, phù hợp với các cơ sở giáo dục hoặc doanh nghiệp.
Vì sao nên chọn EduBase?
EduBase cách mạng hóa việc học kỹ thuật số nhờ sự kết hợp độc đáo của các tính năng:
- Hệ thống câu hỏi nâng cao với khả năng tham số hóa, cho phép tạo 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 hợp nhất tập trung toàn bộ nội dung giáo dục của bạn — video, bài thi, tài liệu và mô-đun SCORM — trong một hệ thống trực quan
- 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ó 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ụ có AI hỗ trợ, chẳng hạn như EduBase Assistant, có thể nhanh chóng chuyển đổi nội dung hiện có thành 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 bộ phận đào tạo doanh nghiệp, EduBase có thể mở rộng để đáp ứng nhu cầu cụ thể của bạn, đồng thời duy trì trải nghiệm người dùng trực quan trên mọi thiết bị.
Video giới thiệu
Cùng nhau tạo và tải câu hỏi lên, lên lịch thi và phân tích kết quả của người dùng bằng Claude:
Lấy thông tin xác thực API
Sau khi đăng nhập, trên Dashboard, tìm menu Integrations, nhấp vào "add integration" 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 info@edubase.net.
Công cụ
Mỗi điểm cuối API được tài liệu hóa đều có sẵn dưới dạng một công cụ, có tên là edubase_<method>_<endpoint>. Ví dụ: công cụ dành cho điểm cuối GET /user:me có tên là edubase_get_user_me. Các điểm cuối thẻ, quyền và chuyển giao hoạt động giống nhau với mọi loại nội dung, vì vậy mỗi phương thức chỉ dùng chung một công cụ với đối số type (ví dụ: edubase_post_content_tag cho POST /exam:tag, POST /quiz:tag, v.v.). Xem tài liệu dành cho nhà phát triển để biết thêm thông tin.
Bộ công cụ
Các công cụ được nhóm thành bộ công cụ để bạn chỉ hiển thị những công cụ cần dùng. Ít công cụ hơn sẽ sử dụng ít ngữ cảnh của mô hình hơn và giúp mô hình chọn đúng công cụ dễ dàng hơn. Theo mặc định, mọi bộ công cụ đều được bật.
| Bộ công cụ | Công cụ dành cho |
|---|---|
files | Tải tệp tạm thời lên (luôn bật) |
questions | Câu hỏi |
quizzes | Bộ câu hỏi, câu hỏi trong bộ, cài đặt và cấu hình sẵn để chấm điểm |
exams | Bài thi, cài đặt, người dùng, chứng chỉ, thương hiệu và lộ trình |
results | Kết quả câu hỏi và bài thi, tải chứng chỉ xuống |
users | Người dùng, tên, nhóm và liên kết đăng nhập |
classes | Lớp học và thành viên lớp |
organizations | Tổ chức, thành viên, phòng ban, chức danh, năng lực và webhook |
integrations | Tích hợp và khóa của chúng |
tags | Thẻ và thẻ gắn với nội dung |
permissions | Quyền của người dùng đối với nội dung và chuyển giao quyền sở hữu |
metrics | Chỉ số tùy chỉnh |
Chọn các bộ công cụ bằng danh sách phân tách bằng dấu phẩy trong EDUBASE_TOOLSETS (ví dụ: questions,quizzes,exams). Đặt EDUBASE_READONLY=true để chỉ hiển thị các công cụ đọc dữ liệu (các công cụ get và những công cụ chỉ tạo liên kết tải xuống, như edubase_post_question_export).
Đặt EDUBASE_DYNAMIC_TOOLSETS=true để bật bộ công cụ theo yêu cầu: phiên bắt đầu chỉ với các công cụ thiết yếu, sau đó mô hình bật những bộ công cụ cần dùng bằng công cụ edubase_enable_toolsets (được liệt kê cùng với edubase_list_toolsets). Cách này giúp danh sách công cụ ban đầu gọn hơn đối với các ứng dụng khách tải trước mọi công cụ, nhưng cần ứng dụng khách làm mới danh sách công cụ khi nhận được thông báo về thay đổi.
Khi sử dụng phương thức truyền tải HTTP, ứng dụng khách có thể thu hẹp cấu hình hơn nữa cho phiên của mình bằng các tiêu đề EduBase-Mcp-Toolsets, EduBase-Mcp-ReadOnly và EduBase-Mcp-Dynamic, hoặc các tham số truy vấn toolsets, read_only và dynamic_toolsets (ví dụ: https://domain.edubase.net/mcp?toolsets=exams&read_only=true). Một phiên không thể bật bộ công cụ hoặc công cụ ghi mà cấu hình máy chủ đã tắt.
Prompt
Prompt là các quy trình làm việc có sẵn mà bạn có thể khởi chạy từ ứng dụng khách MCP (ví dụ: từ menu + hoặc /). Các ứng dụng khách hỗ trợ tính năng hoàn tất sẽ gợi ý giá trị cho các đối số khi bạn nhập: loại câu hỏi, cũng như bài thi, bộ câu hỏi và lớp học của bạn.
| Prompt | Chức năng | Đối số |
|---|---|---|
Tạo câu hỏi (edubase_prompt_create_question) | Tạo câu hỏi mới và xuất bản lên QuestionBase của bạn | type, subject, tùy chọn difficulty và language |
Tạo câu hỏi từ tài liệu (edubase_prompt_questions_from_document) | Chuyển tài liệu đính kèm (hoặc đường dẫn tệp hay URL) thành câu hỏi sau khi bạn phê duyệt kế hoạch; có thể thêm câu hỏi vào bộ câu hỏi | document, tùy chọn questions (số lượng), types, quiz và language |
Tạo bài thi (edubase_prompt_create_exam) | Tạo câu hỏi về một chủ đề, tập hợp chúng vào bộ câu hỏi mới và tạo bài thi từ đó | topic, questions (số lượng), tùy chọn types (phân tách bằng dấu phẩy), language và schedule |
Tạo bài thi kèm lộ trình (edubase_prompt_create_exam_journey) | Tạo bài thi như trên, sau đó xây dựng và xuất bản một lộ trình thi ngắn từ bài thi đó, tái sử dụng các bài thi liên quan trong tài khoản của bạn và tạo bộ câu hỏi luyện tập cùng bài thi tiếp theo nếu cần | giống với Tạo bài thi |
Sao chép bài thi (edubase_prompt_copy_exam) | Tạo bài thi mới với cùng bộ câu hỏi và cài đặt, áp dụng cho khung thời gian mới | exam, schedule, tùy chọn title |
Gán lớp vào bài thi (edubase_prompt_assign_class_to_exam) | Gán các thành viên đang hoạt động của một lớp vào bài thi | exam, class |
Tóm tắt kết quả bài thi (edubase_prompt_summarize_exam_results) | Phân tích kết quả bài thi và có thể lưu bản tóm tắt vào bài thi | exam, tùy chọn focus và save (ask, yes hoặc no) |
Kiểm tra lộ trình thi (edubase_prompt_exam_journey_status) | Hiển thị tiến độ của người dùng trên lộ trình thi và cho biết ai đang bị mắc kẹt | exam |
Prompt chỉ được cung cấp khi bộ công cụ tương ứng được bật; ở chế độ chỉ đọc, chỉ hai prompt cuối được cung cấp.
Khi không điền loại câu hỏi cho bài thi, các ứng dụng khách hỗ trợ tính năng gợi hỏi sẽ yêu cầu bạn chọn loại câu hỏi bằng các hộp kiểm. Các ứng dụng khách này cũng yêu cầu bạn xác nhận những thay đổi không thể hoàn tác (xóa bài thi, bộ câu hỏi, câu hỏi, người dùng, tổ chức và tích hợp; chuyển giao quyền sở hữu; bắt đầu vòng thi mới và xoay vòng khóa tích hợp) trước khi thực hiện. Đặt EDUBASE_ELICITATION=false để tắt các câu hỏi xác nhận này.
Tài nguyên
Tài liệu tham khảo có sẵn dưới dạng tài nguyên và thông qua công cụ edubase_mcp_reference dành cho các mô hình không thể đọc tài nguyên: edubase://reference/questions (các trường và loại câu hỏi) và edubase://reference/exam-journeys (định dạng lộ trình thi có thể chuyển đổi). Tài liệu này bao quát những nội dung được giải thích trong các kỹ năng EduBase, dành cho các ứng dụng khách không có kỹ năng đó. Bài thi và bộ câu hỏi cũng có thể được đính kèm dưới dạng tài nguyên (edubase://exam/{exam} và edubase://quiz/{quiz}), kèm danh sách và gợi ý nội dung của bạn. Tắt các tài nguyên này bằng EDUBASE_CONTENT_RESOURCES=false, hoặc cho một phiên bằng tiêu đề EduBase-Mcp-Content-Resources: false, tham số truy vấn content_resources=false hoặc cài đặt Smithery edubaseContentResources.
Các công cụ tạo hoặc thay đổi bài thi, bộ câu hỏi và lộ trình sẽ liên kết đến trang tương ứng của chúng trong EduBase.
Cấu hình
Có thể cấu hình máy chủ MCP bằng các biến môi trường. Các biến sau đây hiện có:
| Biến | Mô tả | Bắt buộc | Giá trị mặc định |
|---|---|---|---|
EDUBASE_API_URL | URL cơ sở của API EduBase, nhiều khả năng là https://subdomain.edubase.net/api. | Có | https://www.edubase.net/api |
EDUBASE_API_APP | App ID của ứng dụng tích hợp của bạn trên EduBase, tức 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 bắt buộc nếu dùng truyền tải HTTP có xác thực, nếu không thì Có | - |
EDUBASE_API_KEY | Khóa Secret của ứng dụng tích hợp của bạn trên EduBase, tức secret trên API EduBase. Tìm thông tin này cùng với App ID trong cửa sổ chi tiết tích hợp trên EduBase. | Không bắt buộc nếu dùng truyền tải HTTP có xác thực, nếu không thì Có | - |
EDUBASE_SSE_MODE | Khởi chạy 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 chạy máy chủ MCP ở chế độ HTTP với truyền tải HTTP có thể truyền luồng. Giá trị phải là true. | Không | false |
EDUBASE_TOOLSETS | Danh sách phân tách bằng dấu phẩy gồm các toolset được bật, hoặc all. | Không | all |
EDUBASE_READONLY | Chỉ hiển thị các công cụ đọc dữ liệu. Giá trị phải là true. | Không | false |
EDUBASE_OUTPUT_SCHEMAS | Lược đồ đầu ra của công cụ và kết quả công cụ có cấu trúc: off liệt kê các công cụ không có lược đồ đầu ra và chỉ trả về kết quả dưới dạng văn bản JSON, on bao gồm đầy đủ lược đồ đầu ra, fields bao gồm lược đồ đầu ra nhưng không có mô tả trường (vẫn giữ kết quả có cấu trúc nhưng tiết kiệm phần lớn token của lược đồ). | Không | fields |
EDUBASE_CONFIG_PROVIDERS | Danh sách phân tách bằng dấu phẩy gồm các nhà cung cấp dịch vụ lưu trữ được phép cung cấp cấu hình phiên trong yêu cầu khi sử dụng truyền tải HTTP. Hiện chỉ hỗ trợ smithery (tham số truy vấn config được mã hóa base64). | Không | - |
EDUBASE_CONTENT_RESOURCES | Liệt kê các bài thi và bộ câu hỏi Quiz của tài khoản dưới dạng tài nguyên. Đặt thành false để tắt, chẳng hạn khi kiểm tra máy chủ mà không có thông tin xác thực. Tài liệu tham khảo vẫn khả dụng. | Không | true |
EDUBASE_DYNAMIC_TOOLSETS | Bắt đầu phiên chỉ với các công cụ tải tệp lên và để mô hình bật toolset theo yêu cầu. Giá trị phải là true. | Không | false |
EDUBASE_ELICITATION | Yêu cầu người dùng xác nhận các thay đổi không thể hoàn tác và chọn loại câu hỏi cho lời nhắc thông qua ứng dụng khách, nếu ứng dụng khách hỗ trợ tính năng gợi ý thông tin. Đặt thành false để tắt. | Không | true |
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 luồng. | 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 chưa xác thực bị từ chối với 401 + WWW-Authenticate trỏ đến /.well-known/oauth-protected-resource/mcp, và bearer token được chuyển tiếp đến API EduBase. | Không | false |
EDUBASE_OAUTH_AUTHORIZATION_SERVER | URL cơ sở công khai của bản triển khai EduBase đóng vai trò IdP OAuth. Dùng để cô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 | suy ra từ EDUBASE_API_URL |
EDUBASE_OAUTH_RESOURCE_URL | URL cơ sở công khai của chính máy chủ MCP này (chỉ báo tài nguyên OAuth). Dùng trong tiêu đề WWW-Authenticate và siêu dữ liệu tài nguyên. | Không | suy ra từ EDUBASE_API_URL |
EDUBASE_ALLOW_PRIVATE_NETWORK | Khi sử dụng truyền tải HTTP, công cụ edubase_filebin chặn các yêu cầu gửi đi đến địa chỉ riêng tư, loopback, liên kết cục bộ và địa chỉ dành riêng (bảo vệ SSRF), đồng thời từ chối đường dẫn tệp cục bộ. Đặt thành true để cho phép, chẳng hạn với bản triển khai tự lưu trữ trên mạng riêng đáng tin cậy. Không có tác dụng ở chế độ stdio, nơi người dùng cục bộ là bên gọi duy nhất. | Không | false |
EDUBASE_FILEBIN_ALLOWED_HOSTS | Danh sách cho phép tùy chọn, phân tách bằng dấu phẩy, gồm các tên máy chủ được phép làm đích tải lên edubase_filebin (tên máy chủ chính xác hoặc mọi tên miền con, ví dụ edubase.net). Khi để trống, mọi máy chủ công khai đều được phép (vẫn chịu sự lọc địa chỉ nêu trên). | Không | - |
Sử dụng làm máy chủ MCP từ xa
Bạn có thể sử dụng máy chủ MCP EduBase làm máy chủ MCP từ xa cho ứng dụng khách MCP của mình. Để thực hiện việc này, bạn cần lưu trữ máy chủ MCP ở nơi các ứng dụng khách có thể truy cập, sau đó cấu hình ứng dụng khách để kết nối với máy chủ. Hãy khởi chạy máy chủ ở chế độ truyền tải SSE hoặc HTTP có thể truyền luồng 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 xác thực ứng dụng khách: Ở chế độ này, máy chủ không yêu cầu ứng dụng khách xác thực. Chế độ 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ị dùng trong môi trường sản xuất. Để sử dụng chế độ này, bạn cũng phải cấu hình máy chủ với
EDUBASE_API_APPvàEDUBASE_API_KEY! - Xác thực bằng Bearer token: Ở chế độ này, máy chủ yêu cầu gửi Bearer token cùng mỗi yêu cầu. Đây là cách được khuyến nghị để sử dụng máy chủ trong môi trường sản xuất. Bạn có thể lấy Bearer token từ tài khoản EduBase bằng cách tạo ứng dụng tích hợp và cung cấp App ID cùng khóa Secret theo định dạng
{app}:{secret}, được mã hóa base64 thành token. Sau đó, máy chủ sẽ dùng token này để xác thực ứng dụng khách và cấp 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 ứng dụng 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.) sẽ tìm 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 chấp thuận của EduBase và đổi mã ủy quyền (với PKCE S256) lấy access token không trong suốt. Máy chủ MCP chuyển tiếp nguyên trạng token đó đến API EduBase, nơi token được ánh xạ tới tích hợp MCP tự động cấp phát, được tạo khi người dùng chấp thuận lần đầu. Không cần sao chép App ID/Secret — người dùng chỉ cần nhấp vào "Connect EduBase" trong ứng dụng khách.
Sử dụng với Claude Desktop
Để xem hướng dẫn từng bước, hãy đọc 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 đầy đủ.
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 cấu hình, chỉ cần thêm máy chủ này làm máy chủ từ xa trong ứng dụng khách bằng URL https://domain.edubase.net/mcp (thay bằng tên miền thực tế), nếu ứng dụng khách hỗ trợ xác thực OAuth, hoặc dùng Bearer token phù 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ủ do chúng tôi duy trì và cập nhật, nên bạn không cần lo việc lưu trữ hay cấu hình. 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 ứng dụng khách.
Cài đặt thủ công
Thêm nội dung sau vào claude_desktop_config.json:
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 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 bản phát hành máy chủ MCP EduBase xuống, hay sao chép kho lưu trữ rồi chạy npm run build để xây dựng máy chủ. Đừng quên điều chỉnh /path/to/dist cho đúng 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 và đang chạy Docker. Bạn có thể tải xuống từ docker.com hoặc dùng trình quản lý gói. Đừng quên cấu hình các biến môi trường! Image có sẵn cho linux/amd64 và linux/arm64 trên Docker Hub với tên edubase/mcp và trên GitHub Packages với tên ghcr.io/edubase/mcp.
{
"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ó) làm máy chủ từ xa. Chúng tôi khuyến nghị mã hóa Base64 EDUBASE_API_APP và EDUBASE_API_KEY, rồi sử dụng chúng làm Bearer token 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
Để tự động cài đặt máy chủ MCP EduBase cho Claude Desktop thông qua Smithery:
npx -y @smithery/cli install @EduBase/MCP --client claude
Phát triển
Chạy npm test để xây dựng máy chủ và kiểm tra danh sách công cụ: giới hạn kích thước của danh sách công cụ và hướng dẫn máy chủ, mô tả công cụ, toolset, các chế độ toolset chỉ đọc và động, cũng như cách xử lý cấu hình của truyền tải HTTP. Khi công cụ mới vượt quá giới hạn, hãy rút gọn lược đồ của chúng hoặc chủ động tăng giới hạn trong test/server.test.mjs, vì mỗi ứng dụng khách đều phải tải danh sách công cụ trong mỗi phiên.
Các tài liệu tham khảo trong src/references được tạo từ tài liệu dành cho nhà phát triển EduBase. Hãy tạo lại chúng bằng node scripts/sync-references.mjs <path to the developer documentation repository> khi các trường câu hỏi hoặc định dạng quy trình bài thi thay đổi.
Việc hợp nhất một pull request có nhãn major, minor hoặc patch sẽ ghi phiên bản tiếp theo vào main và khởi chạy quy trình Publish. Quy trình này phát hành gói lên npm và MCP Registry, phát hành image container lên Docker Hub và GitHub Packages, đồng thời gắn thẻ commit và tạo bản phát hành GitHub sau khi tất cả các bước thành công. Nếu không có một trong các nhãn này thì sẽ không có gì được phát hành. Phiên bản được đặt thủ công trong pull request sẽ được phát hành nguyên trạng. Commit, thẻ và bản phát hành được tạo bởi một ứng dụng phát hành chuyên dụng, có thông tin xác thực trong môi trường release. Quy trình Publish chạy kiểm thử trước, kiểm tra image đã xây dựng trước khi đẩy lên, và đăng nhập vào Docker Hub bằng OIDC, sử dụng các biến DOCKERHUB_OIDC_CONNECTIONID và DOCKERHUB_OIDC_USERNAME. Quy trình đẩy lên GitHub Packages bằng GITHUB_TOKEN của job, vì GitHub từ chối token GitHub App tại đó. Chạy quy trình thủ công với một phiên bản để thử lại hoặc xây dựng lại bản phát hành: những gì đã có trên npm và MCP Registry sẽ được bỏ qua, và latest chỉ được cập nhật cho bản phát hành mới nhất.
Mốc đồng bộ tài liệu: công cụ, lời nhắc và tài liệu tham khảo được đồng bộ lần cuối vào 2026-11-06 với tài liệu dành cho nhà phát triển được đồng bộ theo bản phát hành EduBase
8.6.6(pull request tài liệu cho8.6.6), đối chiếu với EduBase tại commita29c6af51. Để cập nhật máy chủ, hãy chạygit log --oneline <commit>..HEADvàgit diff <commit>..HEAD -- docs/api/endpointstrong kho lưu trữ tài liệu dành cho nhà phát triển, từ commit của pull request tài liệu cho8.6.6, cập nhật các công cụ bị ảnh hưởng trongsrc/tools(cùng lời nhắc và hướng dẫn toolset của chúng), tạo lại tài liệu tham khảo và cập nhật mốc này thành các commit HEAD mới. Nếu hai bên có khác biệt, kho lưu trữ EduBase được ưu tiên.
Liên hệ
Trang web: www.edubase.net
Tài liệu dành cho nhà phát triển: developer.edubase.net
Email: info@edubase.net