EduBase MCP Server

Server MCP EduBase

Repositori ini berisi implementasi Model Context Protocol (MCP) server untuk platform EduBase. Ini memungkinkan klien MCP (misalnya Claude Desktop) dan LLM untuk berinteraksi dengan akun EduBase Anda dan melakukan tugas atas nama Anda. Ini mendukung protokol transport stdio, SSE, dan HTTP streamable.

Apa itu EduBase?

EduBase adalah platform pendidikan online yang inovatif, modular, yang membuat pembelajaran lebih menyenangkan, sederhana, dan interaktif, cocok untuk institusi pendidikan atau perusahaan.

Mengapa memilih EduBase?

EduBase merevolusi pembelajaran digital dengan kombinasi fitur uniknya:

• Sistem Kuis Canggih dengan parametrisasi yang memungkinkan variasi tak terbatas dari pertanyaan yang sama, deteksi kecurangan waktu nyata, penataan LaTeX yang indah, dukungan STEM tingkat lanjut, dan penilaian otomatis
• Lingkungan Pembelajaran Terpadu yang memusatkan semua konten pendidikan Anda — video, ujian, dokumen, dan modul SCORM — dalam satu sistem yang intuitif
• Keamanan Tingkat Perusahaan dengan fitur seperti integrasi SSO, kontrol akses terperinci, audit komprehensif, dan kepatuhan GDPR
• Integrasi dengan sistem Anda yang sudah ada melalui LTI, API komprehensif, dan opsi integrasi kustom
• Alat Berbantuan AI, seperti Asisten EduBase, yang dapat langsung mengubah konten Anda yang sudah ada menjadi kuis dan penilaian interaktif, atau menerjemahkan materi Anda dari satu bahasa ke bahasa lain

Dari institusi pendidikan tinggi hingga departemen pelatihan perusahaan, EduBase dapat diskalakan untuk memenuhi kebutuhan spesifik Anda sambil mempertahankan pengalaman pengguna yang intuitif di semua perangkat.

Video demo

Membuat dan mengunggah pertanyaan secara kolaboratif, menjadwalkan ujian, dan menganalisis hasil pengguna dengan Claude:

Mendapatkan kredensial API Anda

Setelah masuk, di Dasbor Anda, cari menu Integrasi, klik "tambah integrasi" dan pilih jenis "EduBase API".

Jika Anda tidak melihat opsi ini, masukkan kode aktivasi MCPGITHUB atau jangan ragu untuk menghubungi kami untuk meminta akses di [email protected].

Alat

Setiap endpoint API yang didokumentasikan tersedia sebagai alat terpisah, bernama edubase_<method>_<endpoint>. Misalnya, alat untuk endpoint GET /user:me bernama edubase_get_user_me. Lihat dokumentasi pengembang kami untuk informasi lebih lanjut.

Konfigurasi

Server MCP dapat dikonfigurasi menggunakan variabel lingkungan. Variabel berikut tersedia:

Variabel	Deskripsi	Diperlukan	Nilai default
EDUBASE_API_URL	URL dasar API EduBase, kemungkinan besar https://subdomain.edubase.net/api.	Ya	https://www.edubase.net/api
EDUBASE_API_APP	App ID aplikasi integrasi Anda di EduBase, app di API EduBase. Temukan ini di jendela detail integrasi di EduBase.	Tidak jika transport HTTP digunakan dengan autentikasi, jika tidak Ya	-
EDUBASE_API_KEY	Kunci Rahasia aplikasi integrasi Anda di EduBase, secret di API EduBase. Temukan ini bersama App ID di jendela detail integrasi di EduBase.	Tidak jika transport HTTP digunakan dengan autentikasi, jika tidak Ya	-
EDUBASE_SSE_MODE	Mulai server MCP dalam mode HTTP dengan transport SSE. Nilai harus true.	Tidak	false
EDUBASE_STREAMABLE_HTTP_MODE	Mulai server MCP dalam mode HTTP dengan transport HTTP streamable. Nilai harus true.	Tidak	false
EDUBASE_HTTP_PORT	Server HTTP akan mendengarkan pada port ini jika mode transport SSE atau HTTP streamable digunakan.	Tidak	3000
EDUBASE_OAUTH	Mengaktifkan perilaku sumber daya terlindungi OAuth 2.1: permintaan yang tidak diautentikasi ditolak dengan 401 + WWW-Authenticate yang menunjuk ke /.well-known/oauth-protected-resource, dan token bearer diteruskan ke API EduBase.	Tidak	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	URL dasar publik dari deployment EduBase yang bertindak sebagai IdP OAuth. Digunakan untuk mengiklankan server otorisasi dalam dokumen metadata sumber daya terlindungi.	Tidak	berasal dari EDUBASE_API_URL
EDUBASE_OAUTH_RESOURCE_URL	URL dasar publik dari server MCP ini (indikator sumber daya OAuth). Digunakan di header WWW-Authenticate dan metadata sumber daya.	Tidak	berasal dari EDUBASE_API_URL

Penggunaan sebagai server MCP jarak jauh

Anda dapat menggunakan server MCP EduBase sebagai server MCP jarak jauh untuk klien MCP Anda. Untuk melakukan ini, Anda perlu menghosting server MCP di tempat yang dapat diakses oleh klien, lalu mengonfigurasi klien untuk terhubung ke server. Mulai dengan mode transport SSE atau HTTP streamable dan selalu gunakan HTTPS saat mengakses server dari jarak jauh melalui internet!

Autentikasi dengan server jarak jauh

Anda dapat menggunakan server dalam dua mode:

• Tanpa autentikasi klien: Dalam mode ini, server tidak akan memerlukan autentikasi apa pun dari klien. Ini berguna untuk pengujian atau pengembangan, atau di jaringan tertutup tetapi tidak disarankan untuk penggunaan produksi. Untuk ini, Anda harus mengonfigurasi server dengan EDUBASE_API_APP dan EDUBASE_API_KEY juga!
• Dengan autentikasi token Bearer: Dalam mode ini, server akan memerlukan token Bearer untuk dikirim dengan setiap permintaan. Ini adalah cara yang disarankan untuk menggunakan server dalam produksi. Anda dapat memperoleh token Bearer dari akun EduBase Anda dengan membuat aplikasi integrasi dan memberikan App ID dan Kunci Rahasia dalam format {app}:{secret}, dienkode base64 sebagai token. Server kemudian akan menggunakan token ini untuk mengautentikasi klien dan mengotorisasi akses ke endpoint API.
• Dengan OAuth 2.1 (EduBase sebagai IdP): Saat EDUBASE_OAUTH=true, klien yang kompatibel (Claude Desktop, konektor Claude.ai, Cursor, konektor ChatGPT, dll.) menemukan server otorisasi EduBase melalui /.well-known/oauth-protected-resource, mendaftarkan diri secara dinamis (RFC 7591), memandu pengguna melalui layar persetujuan EduBase, dan menukar kode otorisasi (dengan PKCE S256) untuk token akses buram. Server MCP meneruskan token tersebut secara verbatim ke API EduBase, yang menyelesaikannya ke integrasi MCP yang diprovisikan secara otomatis, dibuat pada persetujuan pertama. Tidak perlu menyalin App ID/Rahasia — pengguna cukup klik "Hubungkan EduBase" di klien mereka.

Penggunaan dengan Claude Desktop

Untuk panduan langkah demi langkah, lihat postingan blog kami tentang cara menghubungkan EduBase dengan Claude: Panduan Integrasi MCP Lengkap.

Menggunakan server MCP EduBase yang disediakan

Anda dapat menggunakan server MCP EduBase yang disediakan (jika tersedia) tanpa konfigurasi apa pun, cukup dengan menambahkannya sebagai server jarak jauh di klien Anda dengan URL https://domain.edubase.net/mcp (ganti dengan domain sebenarnya), jika mendukung autentikasi OAuth, atau dengan token Bearer yang sesuai di header Authorization (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

Direkomendasikan untuk pengguna www.edubase.net, karena server dikelola dan diperbarui oleh kami, dan Anda tidak perlu khawatir tentang hosting atau konfigurasi. Pastikan untuk menggunakan URL dan metode autentikasi yang benar saat menghubungkan klien Anda.

Menginstal secara manual

Tambahkan yang berikut ke claude_desktop_config.json Anda:

Menggunakan Node.js

Sebelum menjalankan server MCP, pastikan Anda telah menginstal Node.js. Anda dapat mengunduhnya dari nodejs.org atau menggunakan manajer paket seperti 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"
      }
    }
  }
}

Atau unduh rilis server MCP EduBase atau kloning repositori dan jalankan npm run build untuk membangun server. Jangan lupa untuk menyesuaikan /path/to/dist ke direktori sebenarnya dan konfigurasikan variabel lingkungan!

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

Menggunakan Docker

Sebelum menjalankan server MCP, pastikan Anda telah menginstal Docker dan sedang berjalan. Anda dapat mengunduhnya dari docker.com atau menggunakan manajer paket. Jangan lupa untuk konfigurasikan variabel lingkungan!

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

Menginstal melalui server MCP jarak jauh

Anda dapat menggunakan server MCP EduBase yang disediakan (jika tersedia) sebagai server jarak jauh. Kami merekomendasikan untuk mengenkode Base64 EDUBASE_API_APP dan EDUBASE_API_KEY Anda dan menggunakannya sebagai token Bearer di header 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}"
      ]
    }
  }
}

Menginstal melalui Smithery

Untuk menginstal server MCP EduBase untuk Claude Desktop secara otomatis melalui Smithery:

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

Kontak

Situs web: www.edubase.net
Dokumentasi Pengembang: developer.edubase.net
Email: [email protected]