EduBase

EduBase MCP sunucusu

Bu depo, Model Context Protocol (MCP) sunucusunun EduBase platformu için 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ışkan HTTP taşıma protokollerini destekler.

EduBase nedir?

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

Neden EduBase'i seçmelisiniz?

EduBase, benzersiz özellik kombinasyonuyla dijital öğrenmeyi kökten değiştirir:

• Gelişmiş Sınav Sistemi: parametrelendirme ile aynı sorunun sonsuz varyasyonlarına olanak tanır, gerçek zamanlı kopya tespiti, güzel LaTeX dizgisi, gelişmiş STEM desteği ve otomatik notlandırma
• Birleşik Öğrenme Ortamı: tüm eğitim içeriğinizi — videolar, sınavlar, belgeler ve SCORM modülleri — tek bir sezgisel sistemde toplar
• Kurumsal Düzeyde Güvenlik: SSO entegrasyonu, ayrıntılı erişim kontrolleri, kapsamlı denetim ve GDPR uyumluluğu gibi özellikler
• Entegrasyon: LTI, kapsamlı API ve özel entegrasyon seçenekleriyle mevcut sistemlerinizle entegrasyon
• Yapay Zeka Destekli Araçlar: EduBase Assistant gibi, mevcut içeriğinizi anında etkileşimli testlere ve değerlendirmelere dönüştürebilen veya materyallerinizi bir dilden diğerine çevirebilen 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 sorular oluşturma ve yükleme, sınavları planlama ve kullanıcı sonuçlarını analiz etme:

API kimlik bilgilerinizi edinme

Giriş yaptıktan sonra, 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öremiyorsanız, MCPGITHUB aktivasyon kodunu girin veya info@edubase.net adresinden bize ulaşarak erişim talep edin.

Araçlar

Belgelenen her API uç noktası, edubase_<method>_<endpoint> adlı bir araç olarak kullanılabilir. Örneğin, GET /user:me uç noktası için araç edubase_get_user_me olarak adlandırılır. Etiket, izin ve transfer uç noktaları her içerik türü için aynı şekilde çalışır, bu nedenle type bağımsız değişkeniyle yöntem başına tek bir aracı paylaşırlar (ör. POST /exam:tag, POST /quiz:tag vb. için edubase_post_content_tag). Daha fazla bilgi için geliştirici belgelerimize bakın.

Araç setleri

Araçlar araç setlerinde gruplandırılır, böylece yalnızca ihtiyacınız olan araçları açığa çıkarabilirsiniz. Daha az araç, modelin bağlamından daha azını kullanır ve modelin doğru olanı seçmesini kolaylaştırır. Her araç seti varsayılan olarak etkindir.

Araç seti	Araçlar
files	Geçici dosya yüklemeleri (her zaman etkin)
questions	Sorular
quizzes	Test setleri, soruları, ayarları ve notlandırma ön ayarları
exams	Sınavlar, ayarları, kullanıcıları, sertifikaları ve markalama
results	Test ve sınav sonuçları, sertifika indirmeleri
users	Kullanıcılar, adları, grupları ve giriş bağlantıları
classes	Sınıflar ve sınıf üyelikleri
organizations	Kuruluşlar, üyeler, departmanlar, yetkinlikler ve webhook'lar
integrations	Entegrasyonlar ve anahtarları
tags	İçeriklerin etiketleri ve etiket ekleri
permissions	İçeriklerdeki kullanıcı izinleri ve sahiplik transferleri
metrics	Özel metrikler

Araç setlerini EDUBASE_TOOLSETS içinde virgülle ayrılmış bir listeyle seçin (ör. questions,quizzes,exams). Yalnızca veri okuyan araçları (get araçları ve yalnızca indirme bağlantıları oluşturan araçlar, ör. edubase_post_question_export) açığa çıkarmak için EDUBASE_READONLY=true değerini ayarlayın.

EDUBASE_DYNAMIC_TOOLSETS=true değerini ayarlayarak araç setlerini isteğe bağlı olarak etkinleştirin: oturumlar yalnızca kritik araçlarla başlar ve model ihtiyaç duyduğu araç setlerini edubase_enable_toolsets aracıyla (edubase_list_toolsets ile listelenir) etkinleştirir. Bu, her aracı önceden yükleyen istemciler için başlangıç araç listesini küçük tutar, ancak değişiklikler bildirildiğinde araç listesini yenileyen bir istemci gerektirir.

Bir HTTP taşıması kullanıldığında, istemciler EduBase-Mcp-Toolsets, EduBase-Mcp-ReadOnly ve EduBase-Mcp-Dynamic başlıkları veya toolsets, read_only ve dynamic_toolsets sorgu parametreleriyle (ör. https://domain.edubase.net/mcp?toolsets=exams&read_only=true) kendi oturumları için yapılandırmayı daha da daraltabilir. Bir oturum, sunucu yapılandırmasının devre dışı bıraktığı araç setlerini veya yazma araçlarını asla etkinleştiremez.

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'deki entegrasyon uygulamanızın App Kimliği, EduBase API'sindeki app. Bunu EduBase'deki entegrasyon ayrıntıları penceresinde bulun.	HTTP taşıması kimlik doğrulamayla kullanılmıyorsa hayır, aksi takdirde Evet	-
EDUBASE_API_KEY	EduBase'deki entegrasyon uygulamanızın Gizli anahtarı, EduBase API'sindeki secret. Bunu App Kimliği ile birlikte entegrasyon ayrıntıları penceresinde bulun.	HTTP taşıması kimlik doğrulamayla kullanılmıyorsa hayır, aksi takdirde Evet	-
EDUBASE_SSE_MODE	MCP sunucusunu SSE taşımasıyla HTTP modunda başlatın. Değer true olmalıdır.	Hayır	false
EDUBASE_STREAMABLE_HTTP_MODE	MCP sunucusunu akışkan HTTP taşımasıyla HTTP modunda başlatın. Değer true olmalıdır.	Hayır	false
EDUBASE_TOOLSETS	Etkin araç setlerinin virgülle ayrılmış listesi veya all.	Hayır	all
EDUBASE_READONLY	Yalnızca veri okuyan araçları açığa çıkarın. Değer true olmalıdır.	Hayır	false
EDUBASE_OUTPUT_SCHEMAS	Araçların çıktı şemaları ve yapılandırılmış araç sonuçları: off araçları çıktı şemaları olmadan listeler ve sonuçları yalnızca JSON metni olarak döndürür, on eksiksiz çıktı şemalarını içerir, fields alan açıklamaları olmadan çıktı şemalarını içerir (yapılandırılmış sonuçları korur, ancak şemaların belirteçlerinin çoğundan tasarruf sağlar).	Hayır	fields
EDUBASE_CONFIG_PROVIDERS	Bir HTTP taşıması kullanıldığında isteklerde oturum yapılandırması sağlamasına izin verilen barındırma sağlayıcılarının virgülle ayrılmış listesi. Şu anda yalnızca smithery desteklenmektedir (base64 kodlu config sorgu parametresi).	Hayır	-
EDUBASE_DYNAMIC_TOOLSETS	Oturumları yalnızca dosya yükleme araçlarıyla başlatın ve modelin araç setlerini isteğe bağlı olarak etkinleştirmesine izin verin. Değer true olmalıdır.	Hayır	false
EDUBASE_HTTP_PORT	SSE veya akışkan HTTP taşıma modu kullanılıyorsa HTTP sunucusu bu bağlantı noktasında dinler.	Hayır	3000
EDUBASE_OAUTH	OAuth 2.1 korumalı kaynak davranışını etkinleştirir: kimliği doğrulanmamış istekler 401 + WWW-Authenticate ile /.well-known/oauth-protected-resource işaret edilerek reddedilir ve taşıyıcı belirteçler EduBase API'sine iletilir.	Hayır	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	OAuth IdP'si olarak görev yapan EduBase dağıtımının genel temel URL'si. Korumalı kaynak meta veri belgesinde yetkilendirme sunucusunu tanıtmak için kullanılır.	Hayır	EDUBASE_API_URL'den türetilir
EDUBASE_OAUTH_RESOURCE_URL	Bu MCP sunucusunun (OAuth kaynak göstergesi) genel temel URL'si. WWW-Authenticate başlığında ve kaynak meta verilerinde kullanılır.	Hayır	EDUBASE_API_URL'ten türetilir
EDUBASE_ALLOW_PRIVATE_NETWORK	Bir HTTP taşıması kullanıldığında, edubase_filebin aracı özel, geri döngü, bağlantı-yerel ve ayrılmış adreslere giden istekleri engeller (SSRF koruması) ve yerel dosya yollarını reddeder. Bunlara izin vermek için true olarak ayarlayın, ör. güvenilir bir özel ağda kendi kendine barındırılan bir dağıtım. stdio modunda, yerel kullanıcının tek çağıran olduğu durumlarda hiçbir etkisi yoktur.	Hayır	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	edubase_filebin yükleme hedefleri olarak izin verilen ana bilgisayar adlarının isteğe bağlı virgülle ayrılmış izin listesi (tam ana bilgisayar veya herhangi bir alt alan adı, ör. edubase.net). Boş olduğunda, herhangi bir genel ana bilgisayara izin verilir (yine de yukarıdaki adres filtrelemesine tabidir).	Hayır	-

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ışkan HTTP taşıma moduyla başlatın ve internette sunucuya 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 gerektirmez. Bu, test veya geliştirme amaçları veya kapalı bir ağ için 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ı belirteç kimlik doğrulamasıyla: Bu modda sunucu, her istekle birlikte bir Taşıyıcı belirtecin gönderilmesini gerektirir. Sunucuyu üretimde kullanmanın önerilen yolu budur. EduBase hesabınızdan bir entegrasyon uygulaması oluşturarak ve App Kimliği ile Gizli anahtarı {app}:{secret} biçiminde, base64 kodlu bir belirteç olarak sağlayarak Taşıyıcı belirteci alabilirsiniz. Sunucu daha sonra bu belirteci 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 belirteci için bir yetkilendirme kodunu (PKCE S256 ile) değiştirir. MCP sunucusu bu belirteci olduğu gibi EduBase API'sine iletir; API, belirteci ilk onayda oluşturulan otomatik sağlanan MCP entegrasyonuna çözer. Kopyalanacak App Kimliği/Gizli anahtar yok — kullanıcılar istemcilerinde yalnızca "EduBase'e Bağlan"a tıklar.

Claude Desktop ile kullanım

Adım adım bir anlatım için, EduBase'i Claude ile bağlama: Eksiksiz MCP Entegrasyon Rehberi 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 istemcinize https://domain.edubase.net/mcp URL'siyle (gerçek alan adıyla değiştirin) uzak bir sunucu olarak ekleyerek kullanabilirsiniz; OAuth kimlik doğrulamasını destekliyorsa veya Authorization başlığında uygun Taşıyıcı belirteçle (Authorization: Bearer ${BASE64_ENCODED_TOKEN}).

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

Manuel kurulum

Aşağıdakileri claude_desktop_config.json dosyanıza ekleyin:

Node.js kullanarak

MCP sunucusunu çalıştırmadan önce Node.js'in kurulu 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 veya depoyu klonlayın ve sunucuyu derlemek için npm run build komutunu çalıştırın. /path/to/dist değerini 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 kurulu ve çalışır durumda 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 bir sunucu olarak kullanabilirsiniz. EDUBASE_API_APP ve EDUBASE_API_KEY değerlerinizi Base64 kodlamanızı ve bunu Authorization başlığında bir Bearer token olarak kullanmanızı öneririz (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 ile Kurulum

EduBase MCP sunucusunu Claude Desktop için Smithery üzerinden otomatik olarak kurmak için:

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

Geliştirme

Sunucuyu derlemek ve araç listesini kontrol etmek için npm test komutunu çalıştırın: araç listesinin ve sunucu talimatlarının boyut bütçeleri, araç açıklamaları, araç seti, salt okunur ve dinamik araç seti modları ve HTTP taşıma yapılandırmasının işlenmesi. Yeni araçlar bir bütçeyi aştığında, şemalarını kısaltın veya test/server.test.mjs içindeki bütçeyi bilinçli olarak artırın, çünkü her istemci her oturumda araç listesi için ödeme yapar.

İletişim

Web Sitesi: www.edubase.net
Geliştirici Dokümantasyonu: developer.edubase.net
E-posta: info@edubase.net