EduBase MCP Server

ทางการ

โต้ตอบกับ EduBase แพลตฟอร์ม e-learning ที่ครอบคลุม พร้อมความสามารถในการจัดการข้อสอบ การสอบ และการจัดระเบียบเนื้อหาขั้นสูง

GitHub

เอกสาร

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

ที่เก็บนี้ประกอบด้วย การนำ Model Context Protocol (MCP) มาใช้ สำหรับแพลตฟอร์ม EduBase ซึ่งช่วยให้ไคลเอนต์ 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 Assistant ที่สามารถเปลี่ยนเนื้อหาที่มีอยู่ของคุณให้เป็นแบบทดสอบและการประเมินเชิงโต้ตอบได้ทันที หรือแปลเอกสารของคุณจากภาษาหนึ่งเป็นอีกภาษาหนึ่ง

ตั้งแต่สถาบันอุดมศึกษาไปจนถึงแผนกฝึกอบรมขององค์กร 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`	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`	Secret key ของแอปการผสานรวมของคุณบน EduBase ซึ่งก็คือ `secret` บน EduBase API ค้นหาสิ่งนี้พร้อมกับ App ID ในหน้าต่างรายละเอียดการผสานรวมบน EduBase	ไม่จำเป็นหากใช้การขนส่ง HTTP พร้อมการรับรองความถูกต้อง มิฉะนั้น ใช่	-
`EDUBASE_SSE_MODE`	เริ่มเซิร์ฟเวอร์ MCP ในโหมด HTTP ด้วยการขนส่ง SSE ค่าต้องเป็น `true`	ไม่	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	เริ่มเซิร์ฟเวอร์ MCP ในโหมด HTTP ด้วยการขนส่ง HTTP แบบสตรีมได้ ค่าต้องเป็น `true`	ไม่	`false`
`EDUBASE_HTTP_PORT`	เซิร์ฟเวอร์ HTTP จะรับฟังบนพอร์ตนี้หากใช้โหมดการขนส่ง SSE หรือ 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 ที่ทำหน้าที่เป็น OAuth IdP ใช้เพื่อโฆษณาเซิร์ฟเวอร์การอนุญาตในเอกสารข้อมูลเมตาทรัพยากรที่ได้รับการป้องกัน	ไม่	มาจาก `EDUBASE_API_URL`
`EDUBASE_OAUTH_RESOURCE_URL`	URL ฐานสาธารณะของเซิร์ฟเวอร์ MCP นี้ (ตัวบ่งชี้ทรัพยากร OAuth) ใช้ในส่วนหัว `WWW-Authenticate` และข้อมูลเมตาทรัพยากร	ไม่	มาจาก `EDUBASE_API_URL`

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

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

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

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

ไม่มีการรับรองความถูกต้องของไคลเอนต์: ในโหมดนี้ เซิร์ฟเวอร์จะไม่ต้องการการรับรองความถูกต้องใดๆ จากไคลเอนต์ มีประโยชน์สำหรับการทดสอบหรือการพัฒนา หรือในเครือข่ายปิด แต่ไม่แนะนำสำหรับการใช้งานจริง สำหรับสิ่งนี้ คุณต้องกำหนดค่าเซิร์ฟเวอร์ด้วย EDUBASE_API_APP และ EDUBASE_API_KEY เช่นกัน!
ด้วยการรับรองความถูกต้องด้วยโทเค็น Bearer: ในโหมดนี้ เซิร์ฟเวอร์จะต้องการโทเค็น Bearer ที่ส่งมาพร้อมกับแต่ละคำขอ นี่เป็นวิธีที่แนะนำสำหรับการใช้งานเซิร์ฟเวอร์ในการใช้งานจริง คุณสามารถขอรับโทเค็น Bearer ได้จากบัญชี EduBase ของคุณโดยการสร้างแอปการผสานรวมและระบุ App ID และ Secret key ในรูปแบบ {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/Secret — ผู้ใช้เพียงคลิก "เชื่อมต่อ EduBase" ในไคลเอนต์ของพวกเขา

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

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

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

คุณสามารถใช้เซิร์ฟเวอร์ EduBase MCP ที่ให้มา (หากมี) โดยไม่ต้องกำหนดค่าใดๆ เพียงเพิ่มเป็นเซิร์ฟเวอร์ระยะไกลในไคลเอนต์ของคุณด้วย 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 หรือโคลนที่เก็บและรัน 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 ที่ให้มา (หากมี) เป็นเซิร์ฟเวอร์ระยะไกล เราแนะนำให้เข้ารหัส Base64 EDUBASE_API_APP และ EDUBASE_API_KEY ของคุณ และใช้เป็นโทเค็น 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

ติดต่อ

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