EduBase MCP Server

resmi

EduBase ile etkileşime geçin; gelişmiş sınav, test yönetimi ve içerik düzenleme özelliklerine sahip kapsamlı bir e-öğrenme platformu.

GitHub

Dokümantasyon

EduBase MCP sunucusu

Bu depo, EduBase platformu için Model Context Protocol (MCP) sunucusunun uygulamasını içerir. MCP istemcilerinin (örneğin Claude Desktop) ve LLM'lerin EduBase hesabınızla etkileşime girmesine ve sizin adınıza görevler gerçekleştirmesine olanak tanır. stdio, SSE ve akışlı HTTP aktarım protokollerini destekler.

EduBase MCP demo GIF: Claude uploads math questions

EduBase nedir?

EduBase, öğrenmeyi daha keyifli, basit ve etkileşimli hale getiren, eğitim kurumları veya işletmeler için uygun, yenilikçi, modüler, çevrimiçi bir eğitim platformudur.

Neden EduBase'i seçmelisiniz?

EduBase, benzersiz özellik kombinasyonuyla dijital öğrenmede devrim yaratır:

Parametrelendirme ile Gelişmiş Sınav Sistemi aynı sorunun sonsuz varyasyonuna, gerçek zamanlı kopya tespitine, güzel LaTeX dizgisine, gelişmiş STEM desteğine ve otomatik notlandırmaya olanak tanır
Birleşik Öğrenme Ortamı tüm eğitim içeriğinizi — videolar, sınavlar, belgeler ve SCORM modülleri — sezgisel tek bir sistemde merkezileştirir
Kurumsal Düzeyde Güvenlik SSO entegrasyonu, ayrıntılı erişim kontrolleri, kapsamlı denetim ve GDPR uyumluluğu gibi özelliklerle
Entegrasyon LTI, kapsamlı API ve özel entegrasyon seçenekleri aracılığıyla mevcut sistemlerinizle
EduBase Asistanı gibi, mevcut içeriğinizi anında etkileşimli sınavlara ve değerlendirmelere dönüştürebilen veya materyallerinizi bir dilden diğerine çevirebilen Yapay Zeka Destekli Araçlar

Yükseköğretim kurumlarından kurumsal eğitim departmanlarına kadar EduBase, tüm cihazlarda sezgisel bir kullanıcı deneyimi sunarken özel ihtiyaçlarınızı karşılayacak şekilde ölçeklenir.

Demo videosu

Claude ile işbirliği içinde soru oluşturma ve yükleme, sınav planlama ve kullanıcı sonuçlarını analiz etme:

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

API kimlik bilgilerinizi edinme

Giriş yaptıktan sonra, Kontrol Panelinizde Entegrasyonlar menüsünü arayın, "entegrasyon ekle"ye tıklayın ve "EduBase API" türünü seçin.

Bu seçeneği görmüyorsanız, MCPGITHUB aktivasyon kodunu girin veya erişim talep etmek için bizimle [email protected] adresinden iletişime geçmekten çekinmeyin.

Araçlar

Belgelenen her API uç noktası, edubase_<method>_<endpoint> olarak adlandırılan ayrı bir araç olarak kullanılabilir. Örneğin, GET /user:me uç noktası için araç edubase_get_user_me olarak adlandırılır. Daha fazla bilgi için geliştirici belgelerimize bakın.

Yapılandırma

MCP sunucusu, ortam değişkenleri kullanılarak yapılandırılabilir. Aşağıdaki değişkenler mevcuttur:

Değişken	Açıklama	Gerekli	Varsayılan değer
`EDUBASE_API_URL`	EduBase API'sinin temel URL'si, büyük olasılıkla `https://subdomain.edubase.net/api`.	Evet	`https://www.edubase.net/api`
`EDUBASE_API_APP`	EduBase üzerindeki entegrasyon uygulamanızın Uygulama Kimliği, EduBase API'sindeki `app`. Bunu EduBase'deki entegrasyon detayları penceresinde bulabilirsiniz.	HTTP aktarımı kimlik doğrulama ile kullanılıyorsa gerekli değil, aksi takdirde Evet	-
`EDUBASE_API_KEY`	EduBase üzerindeki entegrasyon uygulamanızın Gizli anahtarı, EduBase API'sindeki `secret`. Bunu EduBase'deki entegrasyon detayları penceresinde Uygulama Kimliği ile birlikte bulabilirsiniz.	HTTP aktarımı kimlik doğrulama ile kullanılıyorsa gerekli değil, aksi takdirde Evet	-
`EDUBASE_SSE_MODE`	MCP sunucusunu SSE aktarımı ile HTTP modunda başlatır. Değer `true` olmalıdır.	Hayır	`false`
`EDUBASE_STREAMABLE_HTTP_MODE`	MCP sunucusunu akışlı HTTP aktarımı ile HTTP modunda başlatır. Değer `true` olmalıdır.	Hayır	`false`
`EDUBASE_HTTP_PORT`	SSE veya akışlı HTTP aktarım modu kullanılıyorsa HTTP sunucusu bu portu dinleyecektir.	Hayır	3000
`EDUBASE_OAUTH`	OAuth 2.1 korumalı-kaynak davranışını etkinleştirir: kimlik doğrulanmamış istekler `401 + WWW-Authenticate` ile `/.well-known/oauth-protected-resource` adresini işaret ederek reddedilir ve taşıyıcı token'lar EduBase API'sine iletilir.	Hayır	`false`
`EDUBASE_OAUTH_AUTHORIZATION_SERVER`	OAuth IdP olarak hareket eden EduBase dağıtımının genel temel URL'si. Korumalı kaynak meta veri belgesinde yetkilendirme sunucusunu duyurmak için kullanılır.	Hayır	`EDUBASE_API_URL`'den türetilir
`EDUBASE_OAUTH_RESOURCE_URL`	Bu MCP sunucusunun genel temel URL'si (OAuth kaynak göstergesi). `WWW-Authenticate` başlığında ve kaynak meta verisinde kullanılır.	Hayır	`EDUBASE_API_URL`'den türetilir

Uzak MCP sunucusu olarak kullanım

EduBase MCP sunucusunu, MCP istemciniz için uzak bir MCP sunucusu olarak kullanabilirsiniz. Bunu yapmak için, MCP sunucusunu istemcilerin erişebileceği bir yerde barındırmanız ve ardından istemciyi sunucuya bağlanacak şekilde yapılandırmanız gerekir. SSE veya akışlı HTTP aktarım moduyla başlatın ve sunucuya internet üzerinden uzaktan erişirken her zaman HTTPS kullanın!

Uzak sunucularla kimlik doğrulama

Sunucuyu iki modda kullanabilirsiniz:

İstemci kimlik doğrulaması olmadan: Bu modda, sunucu istemciden herhangi bir kimlik doğrulama talep etmez. Bu, test veya geliştirme amaçları için veya kapalı bir ağda kullanışlıdır ancak üretim kullanımı için önerilmez. Bunun için sunucuyu EDUBASE_API_APP ve EDUBASE_API_KEY ile de yapılandırmanız gerekir!
Taşıyıcı token kimlik doğrulaması ile: Bu modda, sunucu her istekle birlikte bir Taşıyıcı token gönderilmesini gerektirir. Bu, sunucuyu üretimde kullanmanın önerilen yoludur. Taşıyıcı token'ı, bir entegrasyon uygulaması oluşturarak ve {app}:{secret} formatında Uygulama Kimliği ve Gizli anahtarı base64 ile kodlanmış bir token olarak sağlayarak EduBase hesabınızdan edinebilirsiniz. Sunucu daha sonra bu token'ı istemcinin kimliğini doğrulamak ve API uç noktalarına erişimi yetkilendirmek için kullanır.
OAuth 2.1 ile (EduBase IdP olarak): EDUBASE_OAUTH=true olduğunda, uyumlu istemciler (Claude Desktop, Claude.ai bağlayıcıları, Cursor, ChatGPT bağlayıcıları vb.) EduBase yetkilendirme sunucusunu /.well-known/oauth-protected-resource aracılığıyla keşfeder, kendilerini dinamik olarak kaydeder (RFC 7591), kullanıcıyı bir EduBase onay ekranından geçirir ve opak bir erişim token'ı için bir yetkilendirme kodu (PKCE S256 ile) değiştirir. MCP sunucusu bu token'ı olduğu gibi EduBase API'sine iletir, API de bunu ilk onayda oluşturulan otomatik sağlanan MCP entegrasyonuna çözümler. Kopyalanacak Uygulama Kimliği/Gizli anahtar yok — kullanıcılar istemcilerinde sadece "EduBase'e Bağlan"a tıklar.

Claude Desktop ile Kullanım

Adım adım bir kılavuz için, EduBase'i Claude ile Bağlama: Eksiksiz MCP Entegrasyon Kılavuzu hakkındaki blog yazımıza bakın.

Sağlanan EduBase MCP sunucusunu kullanma

Sağlanan EduBase MCP sunucusunu (varsa) herhangi bir yapılandırma olmadan, yalnızca OAuth kimlik doğrulamasını destekliyorsa https://domain.edubase.net/mcp URL'si (gerçek alan adıyla değiştirin) ile veya Authorization başlığında (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) uygun Taşıyıcı token ile istemcinize uzak sunucu olarak ekleyerek kullanabilirsiniz.

www.edubase.net kullanıcıları için önerilir, çünkü sunucu tarafımızdan bakımı yapılır ve güncellenir ve barındırma veya yapılandırma konusunda endişelenmenize gerek kalmaz. İstemcinizi bağlarken doğru URL ve kimlik doğrulama yöntemini kullandığınızdan emin olun.

Manuel kurulum

claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

Node.js kullanarak

MCP sunucusunu çalıştırmadan önce Node.js'in yüklü olduğundan emin olun. nodejs.org adresinden indirebilir veya brew gibi bir paket yöneticisi kullanabilirsiniz.

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

Veya EduBase MCP sunucusu sürümünü indirin ya da depoyu klonlayın ve sunucuyu oluşturmak için npm run build komutunu çalıştırın. /path/to/dist yolunu gerçek dizine göre ayarlamayı ve ortam değişkenlerini yapılandırmayı unutmayın!

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

MCP sunucusunu çalıştırmadan önce Docker'ın yüklü ve çalışıyor olduğundan emin olun. docker.com adresinden indirebilir veya bir paket yöneticisi kullanabilirsiniz. Ortam değişkenlerini yapılandırmayı unutmayın!

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

Uzak MCP sunucusu aracılığıyla kurulum

Sağlanan EduBase MCP sunucusunu (varsa) uzak sunucu olarak kullanabilirsiniz. EDUBASE_API_APP ve EDUBASE_API_KEY bilgilerinizi Base64 ile kodlamanızı ve Authorization başlığında (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) Taşıyıcı token olarak kullanmanızı öneririz.

{
  "mcpServers": {
    "edubase": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://domain.edubase.net/mcp",
        "--header",
        "Authorization: Bearer ${EDUBASE_API_APP}:${EDUBASE_API_KEY}"
      ]
    }
  }
}

Smithery aracılığıyla kurulum

Claude Desktop için EduBase MCP sunucusunu Smithery aracılığıyla otomatik olarak kurmak için:

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

İletişim

Web sitesi: www.edubase.net
Geliştirici Belgeleri: developer.edubase.net
E-posta: [email protected]