Kontent.ai
आधिकारिकअपनी सामग्री और सामग्री मॉडल को किसी भी MCP-संगत AI टूल में प्राकृतिक भाषा का उपयोग करके बनाएं, प्रबंधित करें और अन्वेषण करें।
Kontent Ai MCP के साथ आप क्या कर सकते हैं?
- सामग्री संरचना का अन्वेषण करें —
list-content-types,list-content-type-snippets,list-taxonomy-groups, याlist-assetsके माध्यम से सामग्री प्रकार, स्निपेट, टैक्सोनॉमी, या एसेट्स की सूची माँगें। - सामग्री मॉडल बनाएँ और संशोधित करें — सहायक को नए सामग्री प्रकार, स्निपेट, या टैक्सोनॉमी समूह बनाने, या
create-content-type,patch-content-type, याpatch-taxonomy-groupका उपयोग करके उन्हें अपडेट करने का निर्देश दें। - सामग्री आइटम और वेरिएंट प्रबंधित करें — सहायक से
list-content-item-variants,update-content-item-variant, याsearch-content-item-variantsका उपयोग करके सामग्री आइटम और उनके भाषा वेरिएंट बनाने, अपडेट करने, खोजने, या प्राप्त करने के लिए कहें। - प्रकाशन और वर्कफ़्लो नियंत्रित करें —
publish-content-item-variant,change-content-item-variant-workflow-step, याcancel-scheduled-publishing-content-item-variantके साथ सामग्री को प्रकाशित, अप्रकाशित, शेड्यूल, या जीवनचक्र चरणों में स्थानांतरित करने के लिए कहें। - पर्यावरण सेटिंग्स प्रशासित करें — सहायक को
create-language,patch-collections,create-space, याcreate-workflowका उपयोग करके भाषाएँ, संग्रह, स्पेस, या वर्कफ़्लो प्रबंधित करने का निर्देश दें।
दस्तावेज़
Kontent.ai MCP Server
Kontent.ai के लिए AI-संचालित टूल्स के साथ अपने कंटेंट संचालन को बदलें। अपने पसंदीदा AI-सक्षम संपादक में प्राकृतिक भाषा वार्तालापों के माध्यम से अपनी संरचित सामग्री बनाएं, प्रबंधित करें और अन्वेषण करें।
Kontent.ai MCP Server, Model Context Protocol को लागू करता है ताकि आपके Kontent.ai प्रोजेक्ट्स को Claude, Cursor, और VS Code जैसे AI टूल्स से जोड़ा जा सके। यह AI मॉडल्स को आपकी सामग्री संरचना को समझने और प्राकृतिक भाषा निर्देशों के माध्यम से संचालन करने में सक्षम बनाता है।
✨ मुख्य विशेषताएं
- 🚀 त्वरित प्रोटोटाइपिंग: अपने डायग्राम को सेकंडों में लाइव कंटेंट मॉडल में बदलें
- 📈 डेटा विज़ुअलाइज़ेशन: अपने कंटेंट मॉडल को किसी भी प्रारूप में विज़ुअलाइज़ करें
विषय-सूची
- ✨ मुख्य विशेषताएं
- 🔌 त्वरित आरंभ
- 🛠️ उपलब्ध टूल्स
- ⚙️ कॉन्फ़िगरेशन
- 🔒 सुरक्षा
- 🚀 ट्रांसपोर्ट विकल्प
- 💻 विकास
- लाइसेंस
🔌 त्वरित आरंभ
🔑 पूर्वापेक्षाएँ
MCP सर्वर का उपयोग करने से पहले, आपको चाहिए:
- एक Kontent.ai खाता - साइन अप करें यदि आपके पास खाता नहीं है।
- एक प्रोजेक्ट - प्रोजेक्ट बनाएं जिसके साथ काम करना है।
- Management API कुंजी - कुंजी बनाएं उचित अनुमतियों के साथ।
- Environment ID - अपना environment ID प्राप्त करें।
🛠 सेटअप विकल्प
आप Kontent.ai MCP Server को npx के साथ चला सकते हैं:
STDIO ट्रांसपोर्ट
npx @kontent-ai/mcp-server@latest stdio
Streamable HTTP ट्रांसपोर्ट
npx @kontent-ai/mcp-server@latest shttp
🛠️ उपलब्ध टूल्स
पैच संचालन मार्गदर्शिका
- get-patch-guide – 🚨 किसी भी पैच संचालन से पहले आवश्यक। Kontent.ai के लिए इकाई प्रकार के अनुसार पैच संचालन मार्गदर्शिका प्राप्त करें
कंटेंट प्रकार प्रबंधन
- get-content-type – ID द्वारा Kontent.ai कंटेंट प्रकार प्राप्त करें
- list-content-types – सभी Kontent.ai कंटेंट प्रकार प्राप्त करें
- create-content-type – नया Kontent.ai कंटेंट प्रकार बनाएं
- patch-content-type – पैच संचालन (move, addInto, remove, replace) का उपयोग करके codename द्वारा मौजूदा Kontent.ai कंटेंट प्रकार अपडेट करें
- delete-content-type – ID द्वारा Kontent.ai कंटेंट प्रकार हटाएं
कंटेंट प्रकार स्निपेट प्रबंधन
- get-content-type-snippet – ID द्वारा Kontent.ai कंटेंट प्रकार स्निपेट प्राप्त करें
- list-content-type-snippets – सभी Kontent.ai कंटेंट प्रकार स्निपेट प्राप्त करें
- create-content-type-snippet – नया Kontent.ai कंटेंट प्रकार स्निपेट बनाएं
- patch-content-type-snippet – पैच संचालन (move, addInto, remove, replace) का उपयोग करके ID द्वारा मौजूदा Kontent.ai कंटेंट प्रकार स्निपेट अपडेट करें
- delete-content-type-snippet – ID द्वारा Kontent.ai कंटेंट प्रकार स्निपेट हटाएं
टैक्सोनॉमी प्रबंधन
- get-taxonomy-group – ID द्वारा Kontent.ai टैक्सोनॉमी समूह प्राप्त करें
- list-taxonomy-groups – सभी Kontent.ai टैक्सोनॉमी समूह प्राप्त करें
- create-taxonomy-group – नया Kontent.ai टैक्सोनॉमी समूह बनाएं
- patch-taxonomy-group – पैच संचालन (addInto, move, remove, replace) का उपयोग करके Kontent.ai टैक्सोनॉमी समूह अपडेट करें
- delete-taxonomy-group – ID द्वारा Kontent.ai टैक्सोनॉमी समूह हटाएं
कंटेंट आइटम प्रबंधन
- get-content-item – ID द्वारा Kontent.ai कंटेंट आइटम प्राप्त करें
- get-content-item-variant – Kontent.ai कंटेंट आइटम वैरिएंट (भाषा संस्करण/अनुवाद) प्राप्त करें। वर्तमान संस्करण लौटाता है — यदि ड्राफ्ट मौजूद है तो ड्राफ्ट, अन्यथा प्रकाशित
- get-published-content-item-variant-version – Kontent.ai कंटेंट आइटम वैरिएंट का प्रकाशित संस्करण प्राप्त करें। तब उपयोग करें जब नया ड्राफ्ट संस्करण मौजूद हो लेकिन आपको वर्तमान में प्रकाशित (लाइव) सामग्री की आवश्यकता हो
- get-content-item-translations – सभी Kontent.ai कंटेंट आइटम अनुवाद प्राप्त करें — किसी विशिष्ट कंटेंट आइटम का हर भाषा संस्करण (वैरिएंट)
- list-content-item-variants – कंटेंट आइटम वैरिएंट (भाषा संस्करण/अनुवाद) के साथ Kontent.ai कंटेंट आइटम सूचीबद्ध करें, फ़िल्टर करें, खोजें
- create-content-item – नया Kontent.ai कंटेंट आइटम बनाएं (केवल कंटेनर बनाता है, भाषा संस्करण/अनुवाद जोड़ने के लिए create-content-item-variant का उपयोग करें)
- update-content-item – ID द्वारा मौजूदा Kontent.ai कंटेंट आइटम अपडेट करें। कंटेंट आइटम पहले से मौजूद होना चाहिए - यह टूल नए आइटम नहीं बनाएगा
- delete-content-item – ID द्वारा Kontent.ai कंटेंट आइटम हटाएं
- create-content-item-variant – वर्तमान उपयोगकर्ता को योगदानकर्ता के रूप में निर्दिष्ट करते हुए Kontent.ai कंटेंट आइटम वैरिएंट बनाएं। तत्व मानों को कंटेंट प्रकार में परिभाषित सीमाओं और दिशानिर्देशों को पूरा करना चाहिए। केवल वे तत्व भेजें जिन्हें आप सेट करना चाहते हैं; छोड़े गए तत्व खाली प्रारंभ होते हैं
- update-content-item-variant – कंटेंट आइटम का Kontent.ai कंटेंट आइटम वैरिएंट अपडेट करें। तत्व मानों को कंटेंट प्रकार में परिभाषित सीमाओं और दिशानिर्देशों को पूरा करना चाहिए। केवल वे तत्व भेजें जिन्हें आप बदलना चाहते हैं — छोड़े गए तत्व अछूते रहते हैं। घटकों वाले रिच-टेक्स्ट तत्वों के लिए, पूरा तत्व सबमिट करें (मान और पूर्ण घटक सरणी, जिसमें अछूते छोड़े गए घटक शामिल हैं)
- create-new-content-item-variant-version – Kontent.ai कंटेंट आइटम वैरिएंट का नया संस्करण बनाएं। यह संचालन मौजूदा कंटेंट आइटम वैरिएंट का नया संस्करण बनाता है, जो कंटेंट संस्करणीकरण और प्रकाशित सामग्री से नए ड्राफ्ट बनाने के लिए उपयोगी है
- delete-content-item-variant – Kontent.ai कंटेंट आइटम वैरिएंट हटाएं
- bulk-get-content-item-variants – आइटम और भाषा संदर्भ जोड़ों द्वारा उनके कंटेंट आइटम वैरिएंट के साथ Kontent.ai कंटेंट आइटम बल्क में प्राप्त करें। विशिष्ट आइटम+भाषा जोड़ों के लिए पूर्ण कंटेंट डेटा प्राप्त करने के लिए list-content-item-variants के बाद उपयोग करें। अनुरोधित भाषा में वैरिएंट के बिना आइटम वैरिएंट गुण के बिना आइटम लौटाते हैं। निरंतरता टोकन के साथ पृष्ठांकित परिणाम लौटाता है
- search-content-item-variants – किसी विशिष्ट कंटेंट आइटम वैरिएंट में अर्थ और अवधारणाओं द्वारा सामग्री खोजने के लिए AI-संचालित सिमेंटिक खोज। उपयोग करें: अवधारणात्मक खोजों के लिए जब आप सटीक कीवर्ड नहीं जानते। सीमित फ़िल्टरिंग विकल्प (केवल वैरिएंट ID)
एसेट प्रबंधन
- get-asset – ID द्वारा विशिष्ट Kontent.ai एसेट प्राप्त करें
- list-assets – सभी Kontent.ai एसेट प्राप्त करें
- update-asset – ID द्वारा Kontent.ai एसेट अपडेट करें
एसेट फ़ोल्डर प्रबंधन
- list-asset-folders – सभी Kontent.ai एसेट फ़ोल्डर सूचीबद्ध करें
- patch-asset-folders – पैच संचालन का उपयोग करके Kontent.ai एसेट फ़ोल्डर संशोधित करें (नए फ़ोल्डर जोड़ने के लिए addInto, नाम बदलने के लिए rename, फ़ोल्डर हटाने के लिए remove)
भाषा प्रबंधन
- list-languages – सभी Kontent.ai भाषाएँ प्राप्त करें (सक्रिय और निष्क्रिय दोनों शामिल हैं - is_active गुण जांचें)
- create-language – नई Kontent.ai भाषा बनाएं (भाषाएँ हमेशा सक्रिय के रूप में बनाई जाती हैं)
- patch-language – replace संचालन का उपयोग करके Kontent.ai भाषा अपडेट करें (केवल सक्रिय भाषाओं को संशोधित किया जा सकता है - सक्रिय/निष्क्रिय करने के लिए, Kontent.ai वेब UI का उपयोग करें)
संग्रह प्रबंधन
- list-collections – सभी Kontent.ai संग्रह प्राप्त करें। संग्रह आपके वातावरण में कंटेंट आइटम के लिए सीमाएँ निर्धारित करते हैं और टीम, ब्रांड, या प्रोजेक्ट द्वारा सामग्री व्यवस्थित करने में मदद करते हैं
- patch-collections – पैच संचालन का उपयोग करके Kontent.ai संग्रह अपडेट करें (नए संग्रह जोड़ने के लिए addInto, पुनः क्रमित करने के लिए move, खाली संग्रह हटाने के लिए remove, नाम बदलने के लिए replace)
स्पेस प्रबंधन
- list-spaces – सभी Kontent.ai स्पेस प्राप्त करें
- create-space – वेबसाइट या चैनल प्रबंधित करने के लिए नया Kontent.ai स्पेस बनाएं
- patch-space – replace संचालन का उपयोग करके Kontent.ai स्पेस पैच करें
- delete-space – Kontent.ai स्पेस हटाएं
भूमिका प्रबंधन
- list-roles – सभी Kontent.ai भूमिकाएँ प्राप्त करें। "कस्टम भूमिकाएँ प्रबंधित करें" अनुमति के साथ Enterprise या Flex योजना की आवश्यकता है
वर्कफ़्लो प्रबंधन
- list-workflows – सभी Kontent.ai वर्कफ़्लो प्राप्त करें। वर्कफ़्लो कंटेंट जीवनचक्र चरणों और उनके बीच संक्रमण को परिभाषित करते हैं
- create-workflow – कस्टम चरणों, संक्रमणों, दायरों और भूमिका अनुमतियों के साथ नया Kontent.ai वर्कफ़्लो बनाएं
- update-workflow – ID द्वारा मौजूदा Kontent.ai वर्कफ़्लो अपडेट करें। चरण, संक्रमण, दायरे और भूमिका अनुमतियाँ संशोधित करें। उपयोग में आने वाले चरणों को हटाया नहीं जा सकता
- delete-workflow – ID द्वारा Kontent.ai वर्कफ़्लो हटाएं। वर्कफ़्लो किसी भी कंटेंट आइटम द्वारा उपयोग में नहीं होना चाहिए
- change-content-item-variant-workflow-step – Kontent.ai में कंटेंट आइटम वैरिएंट का वर्कफ़्लो चरण बदलें। यह संचालन कंटेंट आइटम वैरिएंट को वर्कफ़्लो में एक अलग चरण में ले जाता है, जिससे कंटेंट जीवनचक्र प्रबंधन सक्षम होता है जैसे सामग्री को ड्राफ्ट से समीक्षा में, समीक्षा से प्रकाशित में ले जाना आदि
- publish-content-item-variant – Kontent.ai में कंटेंट आइटम के कंटेंट आइटम वैरिएंट को प्रकाशित या शेड्यूल करें। यह संचालन वैरिएंट को तुरंत प्रकाशित कर सकता है या वैकल्पिक समय क्षेत्र निर्दिष्टता के साथ किसी विशिष्ट भविष्य की तिथि और समय पर प्रकाशन के लिए शेड्यूल कर सकता है
- unpublish-content-item-variant – Kontent.ai में कंटेंट आइटम के कंटेंट आइटम वैरिएंट को अप्रकाशित या अप्रकाशन शेड्यूल करें। यह संचालन वैरिएंट को तुरंत अप्रकाशित कर सकता है (इसे Delivery API के माध्यम से अनुपलब्ध बनाकर) या वैकल्पिक समय क्षेत्र निर्दिष्टता के साथ किसी विशिष्ट भविष्य की तिथि और समय पर अप्रकाशन के लिए शेड्यूल कर सकता है
- cancel-scheduled-publishing-content-item-variant – Kontent.ai में कंटेंट आइटम वैरिएंट का शेड्यूल किया गया प्रकाशन रद्द करें। यह संचालन प्रकाशन के लिए शेड्यूल किए गए वैरिएंट को उसके पिछले वर्कफ़्लो चरण में वापस ले जाता है, जिससे आगे संपादन संभव होता है
⚙️ कॉन्फ़िगरेशन
सर्वर दो मोड का समर्थन करता है, प्रत्येक अपने ट्रांसपोर्ट से जुड़ा हुआ है:
| ट्रांसपोर्ट | मोड | प्रमाणीकरण | उपयोग का मामला |
|---|---|---|---|
| STDIO | सिंगल-टेनेंट | पर्यावरण चर | एकल Kontent.ai वातावरण के साथ स्थानीय संचार |
| Streamable HTTP | मल्टी-टेनेंट | प्रति अनुरोध Bearer टोकन | कई वातावरणों को संभालने वाला रिमोट/साझा सर्वर |
सिंगल-टेनेंट मोड (STDIO)
पर्यावरण चर के माध्यम से क्रेडेंशियल कॉन्फ़िगर करें:
| चर | विवरण | आवश्यक |
|---|---|---|
| KONTENT_API_KEY | आपकी Kontent.ai कुंजी | ✅ |
| KONTENT_ENVIRONMENT_ID | आपका environment ID | ✅ |
| appInsightsConnectionString | टेलीमेट्री के लिए Application Insights कनेक्शन स्ट्रिंग | ❌ |
| projectLocation | टेलीमेट्री ट्रैकिंग के लिए प्रोजेक्ट स्थान पहचानकर्ता | ❌ |
| manageApiUrl | कस्टम बेस URL (पूर्वावलोकन वातावरण के लिए) | ❌ |
मल्टी-टेनेंट मोड (Streamable HTTP)
Streamable HTTP ट्रांसपोर्ट के लिए, क्रेडेंशियल प्रति अनुरोध प्रदान किए जाते हैं:
- Environment ID URL पथ पैरामीटर के रूप में:
/{environmentId}/mcp - API कुंजी Authorization हेडर में Bearer टोकन के माध्यम से:
Authorization: Bearer <api-key>
यह एकल सर्वर इंस्टेंस को क्रेडेंशियल पर्यावरण चर की आवश्यकता के बिना कई Kontent.ai वातावरणों के लिए अनुरोध संभालने की अनुमति देता है।
| चर | विवरण | आवश्यक |
|---|---|---|
| PORT | HTTP ट्रांसपोर्ट के लिए पोर्ट (डिफ़ॉल्ट 3001) | ❌ |
| appInsightsConnectionString | टेलीमेट्री के लिए Application Insights कनेक्शन स्ट्रिंग | ❌ |
| projectLocation | टेलीमेट्री ट्रैकिंग के लिए प्रोजेक्ट स्थान पहचानकर्ता | ❌ |
| manageApiUrl | कस्टम बेस URL (पूर्वावलोकन वातावरण के लिए) | ❌ |
🔒 सुरक्षा
अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन
इस सर्वर द्वारा लौटाई गई सामग्री (उदाहरण के लिए, किसी संपादक द्वारा लिखा गया तत्व) में ऐसा टेक्स्ट हो सकता है जिसे कनेक्टेड LLM निर्देशों के रूप में व्याख्या करता है — अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन। एक अपहृत एजेंट को विनाशकारी टूल कॉल (delete / unpublish / overwrite) या अप्रकाशित ड्राफ्ट लीक करने के लिए निर्देशित किया जा सकता है। यह एक उद्योग-व्यापी, अनसुलझी समस्या है जिसे सर्वर अपनी लौटाई गई सामग्री को बदलकर विश्वसनीय रूप से ठीक नहीं कर सकता, इसलिए रक्षा स्तरित है:
- न्यूनतम-विशेषाधिकार वाली Management API कुंजी का उपयोग करें। सर्वर उसे दी गई किसी भी कुंजी के साथ कार्य करता है। रीड-ओनली कुंजी के साथ, किसी अपहृत एजेंट का विनाशकारी कॉल API सीमा पर ही विफल हो जाता है — यह सबसे मज़बूत नियंत्रण है, क्योंकि यह मॉडल के व्यवहार की परवाह किए बिना लागू रहता है।
- इसमें एक मानव को शामिल रखें। हर टूल में MCP एनोटेशन होते हैं — रीड्स
readOnlyHintहैं, केवल-निर्माण करने वाले टूल्स एडिटिव होते हैं, और डेटा को अधिलेखित या हटाने वाले टूल्सdestructiveHintहैं — जिनका उपयोग अनुरूप क्लाइंट रीड्स को स्वतः-अनुमोदित करने और विनाशकारी कॉल से पहले संकेत देने के लिए करते हैं। ऐसे क्लाइंट के साथ सर्वर चलाएं और राइट-सक्षम कुंजी के साथ हेडलेस ऑटो-अप्रूव सेटअप से बचें। - यदि आपका क्लाइंट समर्थन करता है तो क्लाइंट-साइड गेट जोड़ें। कुछ क्लाइंट (उदाहरण के लिए, Claude Code हुक्स) आपको मॉडल से स्वतंत्र रूप से, एक विनाशकारी टूल चलाने से पहले नियतिवादी रूप से संकेत देने की अनुमति देते हैं। यह स्थानीय रूप से कॉन्फ़िगर किया जाता है; एक सर्वर इसे लागू नहीं कर सकता।
ये सुझाव हैं, गारंटी नहीं। सुरक्षा समस्याओं की रिपोर्ट निजी रूप से security@kontent.ai पर करें।
🚀 ट्रांसपोर्ट विकल्प
📟 STDIO ट्रांसपोर्ट
STDIO ट्रांसपोर्ट के साथ सर्वर चलाने के लिए, अपने MCP क्लाइंट को इस प्रकार कॉन्फ़िगर करें:
{
"kontent-ai-stdio": {
"command": "npx",
"args": ["@kontent-ai/mcp-server@latest", "stdio"],
"env": {
"KONTENT_API_KEY": "<management-api-key>",
"KONTENT_ENVIRONMENT_ID": "<environment-id>"
}
}
}
🌊 स्ट्रीमेबल HTTP ट्रांसपोर्ट (मल्टी-टेनेंट)
स्ट्रीमेबल HTTP ट्रांसपोर्ट एक ही सर्वर इंस्टेंस से कई Kontent.ai वातावरणों को सेवा प्रदान करता है। प्रत्येक अनुरोध URL पथ मापदंडों और Bearer प्रमाणीकरण के माध्यम से क्रेडेंशियल प्रदान करता है।
पहले सर्वर प्रारंभ करें:
npx @kontent-ai/mcp-server@latest shttp
VS Code
अपने वर्कस्पेस में एक .vscode/mcp.json फ़ाइल बनाएं:
{
"servers": {
"kontent-ai-multi": {
"uri": "http://localhost:3001/<environment-id>/mcp",
"headers": {
"Authorization": "Bearer <management-api-key>"
}
}
}
}
इनपुट संकेतों के साथ सुरक्षित कॉन्फ़िगरेशन के लिए:
{
"inputs": [
{
"id": "apiKey",
"type": "password",
"description": "Kontent.ai API Key"
},
{
"id": "environmentId",
"type": "text",
"description": "Environment ID"
}
],
"servers": {
"kontent-ai-multi": {
"uri": "http://localhost:3001/${inputs.environmentId}/mcp",
"headers": {
"Authorization": "Bearer ${inputs.apiKey}"
}
}
}
}
Claude Desktop
अपनी Claude Desktop कॉन्फ़िगरेशन फ़ाइल अपडेट करें:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
प्रमाणीकरण हेडर जोड़ने के लिए mcp-remote को प्रॉक्सी के रूप में उपयोग करें:
{
"mcpServers": {
"kontent-ai-multi": {
"command": "npx",
"args": [
"mcp-remote",
"http://localhost:3001/<environment-id>/mcp",
"--header",
"Authorization: Bearer <management-api-key>"
]
}
}
}
Claude Code
CLI का उपयोग करके सर्वर जोड़ें:
claude mcp add --transport http kontent-ai-multi \
"http://localhost:3001/<environment-id>/mcp" \
--header "Authorization: Bearer <management-api-key>"
नोट: आप इसे
urlऔरheadersप्रॉपर्टी के साथ अपने Claude Code सेटिंग्स JSON में भी कॉन्फ़िगर कर सकते हैं।
[!IMPORTANT]
<environment-id>को अपने Kontent.ai वातावरण ID (GUID) से और<management-api-key>को अपनी कुंजी से बदलें।
💻 विकास
🛠 स्थानीय स्थापना
# Clone the repository
git clone https://github.com/kontent-ai/mcp-server.git
cd mcp-server
# Install dependencies
npm ci
# Build the project
npm run build
# Start the server
npm run start:stdio # For STDIO transport
npm run start:shttp # For Streamable HTTP transport
# Start the server with automatic reloading (no need to build first)
npm run dev:stdio # For STDIO transport
npm run dev:shttp # For Streamable HTTP transport
📂 प्रोजेक्ट संरचना
src/- स्रोत कोडtools/- MCP टूल कार्यान्वयनclients/- Kontent.ai API क्लाइंट सेटअपschemas/- डेटा सत्यापन स्कीमाutils/- उपयोगिता फ़ंक्शनerrorHandler.ts- MCP टूल्स के लिए मानकीकृत त्रुटि प्रबंधनthrowError.ts- सामान्य त्रुटि उत्पन्न करने वाली उपयोगिता
server.ts- मुख्य सर्वर सेटअप और टूल पंजीकरणbin.ts- एकल प्रवेश बिंदु जो दोनों ट्रांसपोर्ट प्रकारों को संभालता है
🔍 डिबगिंग
डिबगिंग के लिए, आप MCP इंस्पेक्टर का उपयोग कर सकते हैं:
npx @modelcontextprotocol/inspector -e KONTENT_API_KEY=<key> -e KONTENT_ENVIRONMENT_ID=<env-id> node path/to/build/bin.js
या चल रहे स्ट्रीमेबल HTTP सर्वर पर MCP इंस्पेक्टर का उपयोग करें:
npx @modelcontextprotocol/inspector
यह उपलब्ध टूल्स के निरीक्षण और परीक्षण के लिए एक वेब इंटरफ़ेस प्रदान करता है।
📦 रिलीज़ प्रक्रिया
नया संस्करण जारी करने के लिए:
npm version [patch|minor|major]का उपयोग करके संस्करण बढ़ाएं - यहpackage.json,package-lock.jsonको अपडेट करता है, औरserver.jsonमें सिंक करता है- कमिट को अपनी ब्रांच में पुश करें और एक पुल रिक्वेस्ट बनाएं
- पुल रिक्वेस्ट को मर्ज करें
- संस्करण संख्या को नाम और टैग दोनों के रूप में उपयोग करके, स्वतः-जनित रिलीज़ नोट्स के साथ एक नई GitHub रिलीज़ बनाएं
- रिलीज़ प्रकाशित करने से एक स्वचालित वर्कफ़्लो ट्रिगर होता है जो npm और GitHub MCP रजिस्ट्री पर प्रकाशित करता है
लाइसेंस
MIT