EduBase

EduBase MCP सर्वर

इस रिपॉज़िटरी में मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर का EduBase प्लेटफ़ॉर्म के लिए कार्यान्वयन शामिल है। यह MCP क्लाइंट्स (उदाहरण के लिए Claude Desktop) और LLMs को आपके 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	EduBase API का आधार URL, सबसे संभवतः https://subdomain.edubase.net/api।	हाँ	https://www.edubase.net/api
EDUBASE_API_APP	EduBase पर आपके एकीकरण ऐप का App ID, EduBase API पर app। इसे EduBase पर एकीकरण विवरण विंडो में खोजें।	नहीं यदि HTTP ट्रांसपोर्ट प्रमाणीकरण के साथ उपयोग किया जाता है, अन्यथा हाँ	-
EDUBASE_API_KEY	EduBase पर आपके एकीकरण ऐप की Secret कुंजी, EduBase API पर secret। इसे EduBase पर एकीकरण विवरण विंडो में App ID के साथ खोजें।	नहीं यदि HTTP ट्रांसपोर्ट प्रमाणीकरण के साथ उपयोग किया जाता है, अन्यथा हाँ	-
EDUBASE_SSE_MODE	SSE ट्रांसपोर्ट के साथ HTTP मोड में MCP सर्वर प्रारंभ करें। मान true होना चाहिए।	नहीं	false
EDUBASE_STREAMABLE_HTTP_MODE	streamable HTTP ट्रांसपोर्ट के साथ HTTP मोड में MCP सर्वर प्रारंभ करें। मान true होना चाहिए।	नहीं	false
EDUBASE_TOOLSETS	सक्षम टूलसेट की अल्पविराम-पृथक सूची, या all।	नहीं	all
EDUBASE_READONLY	केवल डेटा पढ़ने वाले उपकरणों को उजागर करें। मान true होना चाहिए।	नहीं	false
EDUBASE_OUTPUT_SCHEMAS	उपकरणों के आउटपुट स्कीमा और संरचित उपकरण परिणाम: off उपकरणों को आउटपुट स्कीमा के बिना सूचीबद्ध करता है और परिणाम केवल JSON टेक्स्ट के रूप में लौटाता है, on में पूर्ण आउटपुट स्कीमा शामिल हैं, fields में फ़ील्ड विवरण के बिना आउटपुट स्कीमा शामिल हैं (संरचित परिणाम रखते हुए, लेकिन स्कीमा के अधिकांश टोकन बचाते हुए)।	नहीं	fields
EDUBASE_CONFIG_PROVIDERS	HTTP ट्रांसपोर्ट का उपयोग करते समय अनुरोधों में सत्र कॉन्फ़िगरेशन प्रदान करने की अनुमति देने वाले होस्टिंग प्रदाताओं की अल्पविराम-पृथक सूची। वर्तमान में केवल smithery समर्थित है (base64-एन्कोडेड config क्वेरी पैरामीटर)।	नहीं	-
EDUBASE_DYNAMIC_TOOLSETS	सत्र केवल फ़ाइल अपलोड उपकरणों के साथ प्रारंभ करें और मॉडल को मांग पर टूलसेट सक्षम करने दें। मान true होना चाहिए।	नहीं	false
EDUBASE_HTTP_PORT	यदि SSE या streamable HTTP ट्रांसपोर्ट मोड का उपयोग किया जाता है तो HTTP सर्वर इस पोर्ट पर सुनेंगे।	नहीं	3000
EDUBASE_OAUTH	OAuth 2.1 संरक्षित-संसाधन व्यवहार सक्षम करता है: अप्रमाणित अनुरोधों को 401 + WWW-Authenticate के साथ अस्वीकार कर दिया जाता है जो /.well-known/oauth-protected-resource की ओर इशारा करता है, और बियरर टोकन EduBase API को अग्रेषित किए जाते हैं।	नहीं	false
EDUBASE_OAUTH_AUTHORIZATION_SERVER	OAuth IdP के रूप में कार्य करने वाली EduBase तैनाती का सार्वजनिक आधार URL। संरक्षित-संसाधन मेटाडेटा दस्तावेज़ में प्राधिकरण सर्वर का विज्ञापन करने के लिए उपयोग किया जाता है।	नहीं	EDUBASE_API_URL से व्युत्पन्न
EDUBASE_OAUTH_RESOURCE_URL	इस MCP सर्वर का सार्वजनिक आधार URL (OAuth संसाधन संकेतक)। WWW-Authenticate हेडर और संसाधन मेटाडेटा में उपयोग किया जाता है।	नहीं	EDUBASE_API_URL से व्युत्पन्न
EDUBASE_ALLOW_PRIVATE_NETWORK	जब HTTP ट्रांसपोर्ट का उपयोग किया जाता है, तो edubase_filebin उपकरण निजी, लूपबैक, लिंक-लोकल और आरक्षित पतों (SSRF सुरक्षा) के लिए आउटबाउंड अनुरोधों को अवरुद्ध करता है और स्थानीय फ़ाइल पथों को अस्वीकार करता है। उन्हें अनुमति देने के लिए true पर सेट करें, जैसे कि विश्वसनीय निजी नेटवर्क पर स्व-होस्टेड तैनाती। stdio मोड में कोई प्रभाव नहीं है, जहां स्थानीय उपयोगकर्ता एकमात्र कॉलर है।	नहीं	false
EDUBASE_FILEBIN_ALLOWED_HOSTS	edubase_filebin अपलोड लक्ष्यों के रूप में अनुमत होस्टनामों की वैकल्पिक अल्पविराम-पृथक अनुमति-सूची (सटीक होस्ट या कोई भी सबडोमेन, जैसे edubase.net)। खाली होने पर, कोई भी सार्वजनिक होस्ट अनुमत है (अभी भी उपरोक्त पता फ़िल्टरिंग के अधीन)।	नहीं	-

रिमोट MCP सर्वर के रूप में उपयोग

आप EduBase MCP सर्वर को अपने MCP क्लाइंट के लिए रिमोट MCP सर्वर के रूप में उपयोग कर सकते हैं। ऐसा करने के लिए, आपको MCP सर्वर को होस्ट करना होगा जहां क्लाइंट इसे एक्सेस कर सकें, और फिर क्लाइंट को सर्वर से कनेक्ट करने के लिए कॉन्फ़िगर करें। इसे SSE या streamable HTTP ट्रांसपोर्ट मोड के साथ प्रारंभ करें और इंटरनेट पर रिमोट से सर्वर तक पहुंचते समय हमेशा HTTPS का उपयोग करें!

रिमोट सर्वर के साथ प्रमाणीकरण

आप सर्वर का उपयोग दो मोड में कर सकते हैं:

• क्लाइंट प्रमाणीकरण के बिना: इस मोड में, सर्वर को क्लाइंट से किसी भी प्रमाणीकरण की आवश्यकता नहीं होगी। यह परीक्षण या विकास उद्देश्यों के लिए, या बंद नेटवर्क में उपयोगी है, लेकिन उत्पादन उपयोग के लिए अनुशंसित नहीं है। इसके लिए, आपको सर्वर को EDUBASE_API_APP और EDUBASE_API_KEY के साथ भी कॉन्फ़िगर करना होगा!
• बियरर टोकन प्रमाणीकरण के साथ: इस मोड में, सर्वर को प्रत्येक अनुरोध के साथ एक बियरर टोकन भेजने की आवश्यकता होगी। यह उत्पादन में सर्वर का उपयोग करने का अनुशंसित तरीका है। आप एक एकीकरण ऐप बनाकर और {app}:{secret} प्रारूप में App ID और Secret कुंजी प्रदान करके, base64 एन्कोडेड टोकन के रूप में अपने EduBase खाते से बियरर टोकन प्राप्त कर सकते हैं। सर्वर तब इस टोकन का उपयोग क्लाइंट को प्रमाणित करने और API एंडपॉइंट्स तक पहुंच को अधिकृत करने के लिए करेगा।
• OAuth 2.1 के साथ (EduBase IdP के रूप में): जब EDUBASE_OAUTH=true, संगत क्लाइंट (Claude Desktop, Claude.ai कनेक्टर, Cursor, ChatGPT कनेक्टर, आदि) /.well-known/oauth-protected-resource के माध्यम से EduBase प्राधिकरण सर्वर की खोज करते हैं, RFC 7591 के अनुसार गतिशील रूप से पंजीकरण करते हैं, उपयोगकर्ता को EduBase सहमति स्क्रीन के माध्यम से ले जाते हैं, और एक अपारदर्शी एक्सेस टोकन के लिए एक प्राधिकरण कोड (PKCE S256 के साथ) का आदान-प्रदान करते हैं। MCP सर्वर उस टोकन को EduBase API को शब्दशः अग्रेषित करता है, जो इसे स्वतः-प्रावधानित MCP एकीकरण में हल करता है, जो पहली सहमति पर बनाया गया है। कॉपी करने के लिए कोई App ID/Secret नहीं — उपयोगकर्ता बस अपने क्लाइंट में "Connect EduBase" पर क्लिक करते हैं।

Claude Desktop के साथ उपयोग

चरण-दर-चरण वॉकथ्रू के लिए, हमारा ब्लॉग पोस्ट देखें कि EduBase को Claude के साथ कैसे कनेक्ट करें: The Complete MCP Integration Guide।

प्रदान किए गए EduBase MCP सर्वर का उपयोग

आप प्रदान किए गए EduBase MCP सर्वर (यदि उपलब्ध हो) का उपयोग बिना किसी कॉन्फ़िगरेशन के कर सकते हैं, बस इसे अपने क्लाइंट में URL https://domain.edubase.net/mcp (वास्तविक डोमेन से बदलें) के साथ रिमोट सर्वर के रूप में जोड़कर, यदि यह OAuth प्रमाणीकरण का समर्थन करता है, या 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 सर्वर (यदि उपलब्ध हो) को रिमोट सर्वर के रूप में उपयोग कर सकते हैं। हम अनुशंसा करते हैं कि आप अपने EDUBASE_API_APP और EDUBASE_API_KEY को Base64 एन्कोड करें और इसे Authorization हेडर (Authorization: Bearer ${BASE64_ENCODED_TOKEN}) में Bearer टोकन के रूप में उपयोग करें।

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

Smithery के माध्यम से इंस्टॉल करना

Smithery के माध्यम से Claude Desktop के लिए EduBase MCP सर्वर को स्वचालित रूप से इंस्टॉल करने के लिए:

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