EduBase

เซิร์ฟเวอร์ MCP ของ EduBase

พื้นที่เก็บข้อมูลนี้ประกอบด้วย การใช้งานเซิร์ฟเวอร์ Model Context Protocol (MCP) สำหรับแพลตฟอร์ม EduBase ซึ่งช่วยให้ไคลเอนต์ MCP (เช่น Claude Desktop) และ LLM สามารถโต้ตอบกับบัญชี EduBase ของคุณและดำเนินงานในนามของคุณได้ รองรับโปรโตคอลการส่งข้อมูลแบบ stdio, SSE และ streamable HTTP

EduBase คืออะไร?

EduBase เป็นแพลตฟอร์มการศึกษาออนไลน์แบบโมดูลาร์ที่สร้างสรรค์ ซึ่งทำให้การเรียนรู้สนุกสนาน ง่ายขึ้น และโต้ตอบได้มากขึ้น เหมาะสำหรับสถาบันการศึกษาหรือองค์กร

ทำไมต้องเลือก EduBase?

EduBase ปฏิวัติการเรียนรู้ดิจิทัลด้วยการผสมผสานคุณสมบัติที่เป็นเอกลักษณ์:

• ระบบแบบทดสอบขั้นสูง พร้อมการกำหนดพารามิเตอร์ที่ให้คำถามเดียวกันมีรูปแบบไม่จำกัด การตรวจจับการทุจริตแบบเรียลไทม์ การเรียงพิมพ์ LaTeX ที่สวยงาม การรองรับ STEM ขั้นสูง และการให้คะแนนอัตโนมัติ
• สภาพแวดล้อมการเรียนรู้แบบรวมศูนย์ ที่รวบรวมเนื้อหาการศึกษาทั้งหมดของคุณ — วิดีโอ ข้อสอบ เอกสาร และโมดูล SCORM — ไว้ในระบบเดียวที่ใช้งานง่าย
• ความปลอดภัยระดับองค์กร พร้อมคุณสมบัติเช่นการรวม SSO การควบคุมการเข้าถึงแบบละเอียด การตรวจสอบอย่างครอบคลุม และการปฏิบัติตาม GDPR
• การผสานรวม กับระบบที่มีอยู่ของคุณผ่าน LTI, API ที่ครอบคลุม และตัวเลือกการผสานรวมแบบกำหนดเอง
• เครื่องมือช่วยเหลือด้วย AI เช่น EduBase Assistant ที่สามารถแปลงเนื้อหาที่มีอยู่ของคุณเป็นแบบทดสอบและแบบประเมินแบบโต้ตอบได้ทันที หรือแปลสื่อการเรียนรู้ของคุณจากภาษาหนึ่งไปยังอีกภาษาหนึ่ง

ตั้งแต่สถาบันอุดมศึกษาไปจนถึงแผนกฝึกอบรมองค์กร EduBase ปรับขนาดได้ตามความต้องการเฉพาะของคุณ พร้อมคงประสบการณ์ผู้ใช้ที่ใช้งานง่ายบนทุกอุปกรณ์

วิดีโอสาธิต

การสร้างและอัปโหลดคำถามร่วมกัน การกำหนดเวลาสอบ และการวิเคราะห์ผลลัพธ์ผู้ใช้กับ Claude:

การขอรับข้อมูลประจำตัว API ของคุณ

เมื่อเข้าสู่ระบบแล้ว บนแดชบอร์ดของคุณ ให้ค้นหาเมนู Integrations คลิก "add integration" และเลือกประเภท "EduBase API"

หากคุณไม่เห็นตัวเลือกนี้ ให้ป้อนรหัสเปิดใช้งาน MCPGITHUB หรือติดต่อเราเพื่อขอสิทธิ์การเข้าถึงได้ที่ info@edubase.net

เครื่องมือ

จุดสิ้นสุด API ที่จัดทำเอกสารไว้แต่ละจุดจะพร้อมใช้งานเป็นเครื่องมือ ชื่อ edubase_<method>_<endpoint> ตัวอย่างเช่น เครื่องมือสำหรับจุดสิ้นสุด GET /user:me มีชื่อว่า edubase_get_user_me จุดสิ้นสุดสำหรับแท็ก สิทธิ์ และการโอนย้ายทำงานในลักษณะเดียวกันสำหรับเนื้อหาทุกประเภท ดังนั้นจึงใช้เครื่องมือเดียวต่อวิธีการ โดยมีอาร์กิวเมนต์ type (เช่น edubase_post_content_tag สำหรับ POST /exam:tag, POST /quiz:tag เป็นต้น) ดู เอกสารสำหรับนักพัฒนา ของเราเพื่อข้อมูลเพิ่มเติม

ชุดเครื่องมือ

เครื่องมือถูกจัดกลุ่มเป็นชุดเครื่องมือ เพื่อให้คุณสามารถเปิดเผยเฉพาะเครื่องมือที่คุณต้องการได้ เครื่องมือน้อยลงใช้บริบทของโมเดลน้อยลง และทำให้โมเดลเลือกเครื่องมือที่ถูกต้องได้ง่ายขึ้น ทุกชุดเครื่องมือเปิดใช้งานตามค่าเริ่มต้น

ชุดเครื่องมือ	เครื่องมือสำหรับ
files	การอัปโหลดไฟล์ชั่วคราว (เปิดใช้งานเสมอ)
questions	คำถาม
quizzes	ชุดแบบทดสอบ คำถาม การตั้งค่า และค่ากำหนดการให้คะแนน
exams	ข้อสอบ การตั้งค่า ผู้ใช้ ใบรับรอง และแบรนด์
results	ผลลัพธ์แบบทดสอบและข้อสอบ การดาวน์โหลดใบรับรอง
users	ผู้ใช้ ชื่อ กลุ่ม และลิงก์เข้าสู่ระบบ
classes	ชั้นเรียนและการเป็นสมาชิกชั้นเรียน
organizations	องค์กร สมาชิก แผนก สมรรถนะ และเว็บฮุค
integrations	การผสานรวมและคีย์ของพวกเขา
tags	แท็กและการแนบแท็กของเนื้อหา
permissions	สิทธิ์ผู้ใช้บนเนื้อหาและการโอนย้ายความเป็นเจ้าของ
metrics	เมตริกที่กำหนดเอง

เลือกชุดเครื่องมือด้วยรายการที่คั่นด้วยเครื่องหมายจุลภาคใน EDUBASE_TOOLSETS (เช่น questions,quizzes,exams) ตั้งค่า EDUBASE_READONLY=true เพื่อเปิดเผยเฉพาะเครื่องมือที่อ่านข้อมูล (เครื่องมือ get และเครื่องมือที่สร้างลิงก์ดาวน์โหลดเท่านั้น เช่น edubase_post_question_export)

ตั้งค่า EDUBASE_DYNAMIC_TOOLSETS=true เพื่อเปิดใช้งานชุดเครื่องมือตามความต้องการ: เซสชันเริ่มต้นด้วยเครื่องมือที่สำคัญเท่านั้น และโมเดลจะเปิดใช้งานชุดเครื่องมือที่ต้องการด้วยเครื่องมือ edubase_enable_toolsets (แสดงรายการด้วย edubase_list_toolsets) ซึ่งช่วยให้รายการเครื่องมือเริ่มต้นมีขนาดเล็กสำหรับไคลเอนต์ที่โหลดทุกเครื่องมือล่วงหน้า แต่ต้องใช้ไคลเอนต์ที่รีเฟรชรายการเครื่องมือเมื่อได้รับการแจ้งเตือนเกี่ยวกับการเปลี่ยนแปลง

เมื่อใช้การส่งข้อมูลแบบ HTTP ไคลเอนต์สามารถจำกัดการกำหนดค่าเพิ่มเติมสำหรับเซสชันของตนเองได้ด้วยส่วนหัว EduBase-Mcp-Toolsets, EduBase-Mcp-ReadOnly และ EduBase-Mcp-Dynamic หรือพารามิเตอร์คิวรี toolsets, read_only และ dynamic_toolsets (เช่น https://domain.edubase.net/mcp?toolsets=exams&read_only=true) เซสชันไม่สามารถเปิดใช้งานชุดเครื่องมือหรือเครื่องมือเขียนที่การกำหนดค่าเซิร์ฟเวอร์ปิดใช้งานได้

การกำหนดค่า

เซิร์ฟเวอร์ MCP สามารถกำหนดค่าได้โดยใช้ตัวแปรสภาพแวดล้อม ตัวแปรต่อไปนี้พร้อมใช้งาน:

ตัวแปร	คำอธิบาย	จำเป็น	ค่าเริ่มต้น
EDUBASE_API_URL	URL ฐานของ EduBase API ซึ่งส่วนใหญ่คือ https://subdomain.edubase.net/api	ใช่	https://www.edubase.net/api
EDUBASE_API_APP	App ID ของแอปการผสานรวมของคุณบน EduBase ซึ่งคือ app บน EduBase API ค้นหาได้ในหน้าต่างรายละเอียดการผสานรวมบน EduBase	ไม่ หากใช้การส่งข้อมูลแบบ HTTP พร้อมการรับรองความถูกต้อง มิฉะนั้น ใช่	-
EDUBASE_API_KEY	คีย์ลับของแอปการผสานรวมของคุณบน EduBase ซึ่งคือ secret บน EduBase API ค้นหาได้พร้อมกับ App ID ในหน้าต่างรายละเอียดการผสานรวมบน EduBase	ไม่ หากใช้การส่งข้อมูลแบบ HTTP พร้อมการรับรองความถูกต้อง มิฉะนั้น ใช่	-
EDUBASE_SSE_MODE	เริ่มเซิร์ฟเวอร์ MCP ในโหมด HTTP ด้วยการส่งข้อมูลแบบ SSE ค่าต้องเป็น true	ไม่	false
EDUBASE_STREAMABLE_HTTP_MODE	เริ่มเซิร์ฟเวอร์ MCP ในโหมด HTTP ด้วยการส่งข้อมูลแบบ streamable HTTP ค่าต้องเป็น true	ไม่	false
EDUBASE_TOOLSETS	รายการที่คั่นด้วยเครื่องหมายจุลภาคของ ชุดเครื่องมือ ที่เปิดใช้งาน หรือ all	ไม่	all
EDUBASE_READONLY	เปิดเผยเฉพาะเครื่องมือที่อ่านข้อมูล ค่าต้องเป็น true	ไม่	false
EDUBASE_OUTPUT_SCHEMAS	สคีมาเอาต์พุตของเครื่องมือและผลลัพธ์เครื่องมือแบบมีโครงสร้าง: off แสดงรายการเครื่องมือโดยไม่มีสคีมาเอาต์พุตและส่งคืนผลลัพธ์เป็นข้อความ JSON เท่านั้น on รวมสคีมาเอาต์พุตที่สมบูรณ์ fields รวมสคีมาเอาต์พุตโดยไม่มีคำอธิบายฟิลด์ (คงผลลัพธ์แบบมีโครงสร้างไว้ แต่ประหยัดโทเค็นส่วนใหญ่ของสคีมา)	ไม่	fields
EDUBASE_CONFIG_PROVIDERS	รายการที่คั่นด้วยเครื่องหมายจุลภาคของผู้ให้บริการโฮสติ้งที่ได้รับอนุญาตให้จัดหาการกำหนดค่าเซสชันในคำขอเมื่อใช้การส่งข้อมูลแบบ HTTP ปัจจุบันรองรับเฉพาะ smithery (พารามิเตอร์คิวรี config ที่เข้ารหัส base64)	ไม่	-
EDUBASE_DYNAMIC_TOOLSETS	เริ่มเซสชันด้วยเครื่องมืออัปโหลดไฟล์เท่านั้น และให้โมเดลเปิดใช้งาน ชุดเครื่องมือ ตามความต้องการ ค่าต้องเป็น true	ไม่	false
EDUBASE_HTTP_PORT	เซิร์ฟเวอร์ HTTP จะฟังพอร์ตนี้หากใช้โหมดการส่งข้อมูลแบบ SSE หรือ streamable HTTP	ไม่	3000
EDUBASE_OAUTH	เปิดใช้งานพฤติกรรมทรัพยากรที่ได้รับการป้องกัน OAuth 2.1: คำขอที่ไม่ได้รับการรับรองความถูกต้องจะถูกปฏิเสธด้วย 401 + WWW-Authenticate ที่ชี้ไปที่ /.well-known/oauth-protected-resource และโทเค็น bearer จะถูกส่งต่อไปยัง EduBase API	ไม่	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	URL ฐานสาธารณะของการติดตั้ง EduBase ที่ทำหน้าที่เป็น IdP ของ OAuth ใช้เพื่อประกาศเซิร์ฟเวอร์การอนุญาตในเอกสารเมตาดาต้าของทรัพยากรที่ได้รับการป้องกัน	ไม่	มาจาก EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	URL ฐานสาธารณะของ เซิร์ฟเวอร์ MCP นี้ (ตัวบ่งชี้ทรัพยากร OAuth) ใช้ในส่วนหัว WWW-Authenticate และเมตาดาต้าทรัพยากร	ไม่	มาจาก EDUBASE_API_URL
EDUBASE_ALLOW_PRIVATE_NETWORK	เมื่อใช้การส่งข้อมูลแบบ HTTP เครื่องมือ edubase_filebin จะบล็อกคำขอขาออกไปยังที่อยู่ส่วนตัว loopback link-local และที่อยู่ที่สงวนไว้ (การป้องกัน SSRF) และปฏิเสธเส้นทางไฟล์ในเครื่อง ตั้งค่าเป็น true เพื่ออนุญาต เช่น การติดตั้งแบบโฮสต์เองบนเครือข่ายส่วนตัวที่เชื่อถือได้ ไม่มีผลในโหมด stdio ซึ่งผู้ใช้ในเครื่องเป็นผู้เรียกเพียงรายเดียว	ไม่	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	รายการอนุญาตที่คั่นด้วยเครื่องหมายจุลภาคแบบไม่บังคับของชื่อโฮสต์ที่ได้รับอนุญาตเป็นเป้าหมายการอัปโหลด edubase_filebin (โฮสต์ที่แน่นอนหรือซับโดเมนใดก็ได้ เช่น edubase.net) เมื่อว่างเปล่า โฮสต์สาธารณะใด ๆ จะได้รับอนุญาต (ยังคงอยู่ภายใต้การกรองที่อยู่ด้านบน)	ไม่	-

การใช้เป็นเซิร์ฟเวอร์ MCP ระยะไกล

คุณสามารถใช้ เซิร์ฟเวอร์ MCP ของ EduBase เป็นเซิร์ฟเวอร์ MCP ระยะไกล สำหรับไคลเอนต์ MCP ของคุณได้ ในการทำเช่นนี้ คุณต้องโฮสต์เซิร์ฟเวอร์ MCP ในตำแหน่งที่ไคลเอนต์สามารถเข้าถึงได้ จากนั้นกำหนดค่าไคลเอนต์ให้เชื่อมต่อกับเซิร์ฟเวอร์ เริ่มต้นด้วยโหมดการส่งข้อมูลแบบ SSE หรือ streamable HTTP และใช้ HTTPS เสมอเมื่อเข้าถึงเซิร์ฟเวอร์ระยะไกลผ่านอินเทอร์เน็ต!

การรับรองความถูกต้องกับเซิร์ฟเวอร์ระยะไกล

คุณสามารถใช้เซิร์ฟเวอร์ได้สองโหมด:

• ไม่มีการรับรองความถูกต้องของไคลเอนต์: ในโหมดนี้ เซิร์ฟเวอร์จะไม่ต้องการการรับรองความถูกต้องใด ๆ จากไคลเอนต์ ซึ่งมีประโยชน์สำหรับการทดสอบหรือการพัฒนา หรือในเครือข่ายปิด แต่ไม่แนะนำสำหรับการใช้งานใน production สำหรับโหมดนี้ คุณต้องกำหนดค่าเซิร์ฟเวอร์ด้วย EDUBASE_API_APP และ EDUBASE_API_KEY ด้วย!
• การรับรองความถูกต้องด้วยโทเค็น Bearer: ในโหมดนี้ เซิร์ฟเวอร์จะต้องส่งโทเค็น Bearer ไปกับทุกคำขอ นี่เป็นวิธีที่แนะนำสำหรับการใช้งานเซิร์ฟเวอร์ใน production คุณสามารถรับโทเค็น Bearer จากบัญชี EduBase ของคุณได้โดยการสร้างแอปการผสานรวมและระบุ App ID และคีย์ลับในรูปแบบ {app}:{secret} ที่เข้ารหัส base64 เป็นโทเค็น จากนั้นเซิร์ฟเวอร์จะใช้โทเค็นนี้เพื่อรับรองความถูกต้องของไคลเอนต์และอนุญาตการเข้าถึงจุดสิ้นสุด API
• ด้วย OAuth 2.1 (EduBase เป็น IdP): เมื่อ EDUBASE_OAUTH=true ไคลเอนต์ที่เข้ากันได้ (Claude Desktop, ตัวเชื่อมต่อ Claude.ai, Cursor, ตัวเชื่อมต่อ ChatGPT เป็นต้น) ค้นพบเซิร์ฟเวอร์การอนุญาต EduBase ผ่าน /.well-known/oauth-protected-resource ลงทะเบียนตนเองแบบไดนามิก (RFC 7591) นำผู้ใช้ผ่านหน้าจอการยินยอมของ EduBase และแลกเปลี่ยนรหัสการอนุญาต (ด้วย PKCE S256) เป็นโทเค็นการเข้าถึงที่ไม่โปร่งใส เซิร์ฟเวอร์ MCP ส่งต่อโทเค็นนั้นไปยัง EduBase API ตามตัวอักษร ซึ่งจะแก้ไขเป็นการผสานรวม MCP ที่จัดเตรียมอัตโนมัติ สร้างขึ้นเมื่อมีการยินยอมครั้งแรก ไม่ต้องคัดลอก App ID/คีย์ลับ — ผู้ใช้เพียงคลิก "Connect EduBase" ในไคลเอนต์ของตน

การใช้งานกับ Claude Desktop

สำหรับคำแนะนำทีละขั้นตอน โปรดดูบทความบล็อกของเราเกี่ยวกับวิธี เชื่อมต่อ EduBase กับ Claude: คู่มือการผสานรวม MCP ฉบับสมบูรณ์

การใช้เซิร์ฟเวอร์ MCP ของ EduBase ที่ให้มา

คุณสามารถใช้เซิร์ฟเวอร์ MCP ของ EduBase ที่ให้มา (หากมี) โดยไม่ต้องกำหนดค่าใด ๆ เพียงเพิ่มเป็นเซิร์ฟเวอร์ระยะไกลในไคลเอนต์ของคุณด้วย URL https://domain.edubase.net/mcp (แทนที่ด้วยโดเมนจริง) หากรองรับการรับรองความถูกต้อง OAuth หรือใช้โทเค็น Bearer ที่เหมาะสมในส่วนหัว Authorization (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 server release หรือโคลนพื้นที่เก็บข้อมูลและรัน 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 และใช้เป็นโทเค็น Bearer ในส่วนหัว 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}"
      ]
    }
  }
}

การติดตั้งผ่าน Smithery

หากต้องการติดตั้งเซิร์ฟเวอร์ EduBase MCP สำหรับ Claude Desktop โดยอัตโนมัติผ่าน Smithery:

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

การพัฒนา

รัน npm test เพื่อสร้างเซิร์ฟเวอร์และตรวจสอบรายการเครื่องมือ: ขนาดงบประมาณของรายการเครื่องมือและคำแนะนำเซิร์ฟเวอร์ คำอธิบายเครื่องมือ ชุดเครื่องมือ โหมดชุดเครื่องมือแบบอ่านอย่างเดียวและแบบไดนามิก และการจัดการการกำหนดค่าของการขนส่ง HTTP เมื่อเครื่องมือใหม่เกินงบประมาณ ให้ย่อโครงร่างของเครื่องมือหรือเพิ่มงบประมาณใน test/server.test.mjs อย่างตั้งใจ เนื่องจากไคลเอนต์ทุกตัวจ่ายค่างบประมาณสำหรับรายการเครื่องมือในทุกเซสชัน

การติดต่อ

เว็บไซต์: www.edubase.net
เอกสารสำหรับนักพัฒนา: developer.edubase.net
อีเมล: info@edubase.net