Kontent.ai

आधिकारिक

अपनी सामग्री और सामग्री मॉडल को किसी भी MCP-संगत AI टूल में प्राकृतिक भाषा का उपयोग करके बनाएं, प्रबंधित करें और अन्वेषण करें।

GitHub

Kontent Ai MCP के साथ आप क्या कर सकते हैं?

सामग्री संरचना का अन्वेषण करें — अपने Kontent.ai प्रोजेक्ट में सभी सामग्री प्रकार, स्निपेट, टैक्सोनॉमी समूह, या एसेट्स की सूची माँगें।
सामग्री मॉडल बनाएँ और संशोधित करें — सहायक को दस्तावेजित ऑपरेशनों का उपयोग करके सामग्री प्रकार, स्निपेट और टैक्सोनॉमी समूह बनाने या पैच करने का निर्देश दें।
सामग्री आइटम और वेरिएंट प्रबंधित करें — सहायक से सामग्री आइटम और उनके भाषा वेरिएंट बनाने, अपडेट करने या प्राप्त करने को कहें, जिसमें प्रकाशित या ड्राफ्ट संस्करण शामिल हों।
सामग्री प्रकाशित और शेड्यूल करें — सहायक को सामग्री आइटम वेरिएंट प्रकाशित, अप्रकाशित या शेड्यूल करने और वर्कफ़्लो चरणों को प्रबंधित करने का निर्देश दें।
सामग्री खोजें और प्राप्त करें — अर्थ के आधार पर सामग्री खोजने के लिए सिमेंटिक खोज का उपयोग करें, या विशिष्ट आइटम और भाषा जोड़े को बल्क-फ़ेच करें।

दस्तावेज़

Kontent.ai MCP सर्वर

Kontent.ai के लिए AI-संचालित टूल्स के साथ अपने कंटेंट संचालन को बदलें। अपने पसंदीदा AI-सक्षम संपादक में प्राकृतिक भाषा संवादों के माध्यम से अपनी संरचित सामग्री बनाएं, प्रबंधित करें और अन्वेषण करें।

Kontent.ai MCP सर्वर मॉडल कॉन्टेक्स्ट प्रोटोकॉल लागू करता है ताकि आपके Kontent.ai प्रोजेक्ट्स को Claude, Cursor, और VS Code जैसे AI टूल्स से जोड़ा जा सके। यह AI मॉडल्स को आपकी सामग्री संरचना को समझने और प्राकृतिक भाषा निर्देशों के माध्यम से संचालन करने में सक्षम बनाता है।

✨ मुख्य विशेषताएं

🚀 त्वरित प्रोटोटाइपिंग: अपने डायग्राम को सेकंडों में लाइव कंटेंट मॉडल में बदलें
📈 डेटा विज़ुअलाइज़ेशन: अपने कंटेंट मॉडल को किसी भी प्रारूप में विज़ुअलाइज़ करें

🔌 त्वरित आरंभ

🔑 पूर्वापेक्षाएँ

MCP सर्वर का उपयोग करने से पहले, आपको चाहिए:

एक Kontent.ai खाता - साइन अप करें यदि आपके पास खाता नहीं है।
एक प्रोजेक्ट - प्रोजेक्ट बनाएं जिसके साथ काम करना है।
प्रबंधन API कुंजी - कुंजी बनाएं उचित अनुमतियों के साथ।
पर्यावरण ID - अपना पर्यावरण ID प्राप्त करें।

🛠 सेटअप विकल्प

आप Kontent.ai MCP सर्वर को npx के साथ चला सकते हैं:

STDIO ट्रांसपोर्ट

npx @kontent-ai/mcp-server@latest stdio

स्ट्रीमेबल HTTP ट्रांसपोर्ट

npx @kontent-ai/mcp-server@latest shttp

🛠️ उपलब्ध टूल्स

पैच संचालन मार्गदर्शिका

get-patch-guide – 🚨 किसी भी पैच संचालन से पहले आवश्यक। इकाई प्रकार के अनुसार Kontent.ai के लिए पैच संचालन मार्गदर्शिका प्राप्त करें

कंटेंट प्रकार प्रबंधन

get-content-type – ID द्वारा Kontent.ai कंटेंट प्रकार प्राप्त करें
list-content-types – सभी Kontent.ai कंटेंट प्रकार प्राप्त करें
list-content-type-usages – सूचीबद्ध करें कि Kontent.ai कंटेंट प्रकार कहाँ उपयोग किया गया है
create-content-type – नया Kontent.ai कंटेंट प्रकार बनाएं
patch-content-type – पैच संचालन (move, addInto, remove, replace) का उपयोग करके कोडनेम द्वारा मौजूदा 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 में कंटेंट आइटम का कंटेंट आइटम वैरिएंट अप्रकाशित या अप्रकाशन शेड्यूल करें। यह संचालन या तो तुरंत वैरिएंट अप्रकाशित कर सकता है (इसे डिलीवरी API के माध्यम से अनुपलब्ध बनाता है) या वैकल्पिक समय क्षेत्र निर्दिष्टीकरण के साथ किसी विशिष्ट भविष्य की तारीख और समय पर अप्रकाशन के लिए शेड्यूल कर सकता है
cancel-scheduled-publishing-content-item-variant – Kontent.ai में कंटेंट आइटम वैरिएंट का शेड्यूल किया गया प्रकाशन रद्द करें। यह संचालन प्रकाशन के लिए शेड्यूल किए गए वैरिएंट को उसके पिछले वर्कफ़्लो चरण में वापस ले जाता है, जिससे आगे संपादन सक्षम होते हैं

⚙️ कॉन्फ़िगरेशन

सर्वर दो मोड का समर्थन करता है, प्रत्येक अपने ट्रांसपोर्ट से जुड़ा हुआ है:

ट्रांसपोर्ट	मोड	प्रमाणीकरण	उपयोग का मामला
STDIO	सिंगल-टेनेंट	पर्यावरण चर	एकल Kontent.ai पर्यावरण के साथ स्थानीय संचार
स्ट्रीमेबल HTTP	मल्टी-टेनेंट	प्रति अनुरोध Bearer टोकन	कई पर्यावरणों को संभालने वाला दूरस्थ/साझा सर्वर

सिंगल-टेनेंट मोड (STDIO)

पर्यावरण चर के माध्यम से क्रेडेंशियल कॉन्फ़िगर करें:

चर	विवरण	आवश्यक
KONTENT_API_KEY	आपकी Kontent.ai कुंजी	✅
KONTENT_ENVIRONMENT_ID	आपका पर्यावरण ID	✅
appInsightsConnectionString	टेलीमेट्री के लिए Application Insights कनेक्शन स्ट्रिंग	❌
projectLocation	टेलीमेट्री ट्रैकिंग के लिए प्रोजेक्ट स्थान पहचानकर्ता	❌
manageApiUrl	कस्टम बेस URL (पूर्वावलोकन पर्यावरणों के लिए)	❌

मल्टी-टेनेंट मोड (स्ट्रीमेबल HTTP)

स्ट्रीमेबल HTTP ट्रांसपोर्ट के लिए, क्रेडेंशियल प्रति अनुरोध प्रदान किए जाते हैं:

पर्यावरण ID URL पथ पैरामीटर के रूप में: /{environmentId}/mcp
API कुंजी Authorization हेडर में Bearer टोकन के माध्यम से: Authorization: Bearer <api-key>

यह एक एकल सर्वर इंस्टेंस को क्रेडेंशियल पर्यावरण चर की आवश्यकता के बिना कई Kontent.ai पर्यावरणों के लिए अनुरोध संभालने की अनुमति देता है।

KONTENT_API_KEY और KONTENT_ENVIRONMENT_ID इस ट्रांसपोर्ट पर अनदेखा किए जाते हैं, भले ही वे सर्वर के पर्यावरण में सेट हों। प्रत्येक अनुरोध को अपने स्वयं के क्रेडेंशियल ले जाने चाहिए; जो नहीं ले जाता उसे सर्वर के साथ सेवा देने के बजाय अस्वीकार कर दिया जाता है।

चर	विवरण	आवश्यक
PORT	HTTP ट्रांसपोर्ट के लिए पोर्ट (डिफ़ॉल्ट 3001)	❌
appInsightsConnectionString	टेलीमेट्री के लिए Application Insights कनेक्शन स्ट्रिंग	❌
projectLocation	टेलीमेट्री ट्रैकिंग के लिए प्रोजेक्ट स्थान पहचानकर्ता	❌
manageApiUrl	कस्टम बेस URL (पूर्वावलोकन पर्यावरणों के लिए)	❌

🔒 सुरक्षा

अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन

इस सर्वर द्वारा लौटाई गई सामग्री (उदाहरण के लिए, किसी संपादक द्वारा लिखा गया तत्व) में ऐसा टेक्स्ट हो सकता है जिसे कनेक्टेड LLM निर्देशों के रूप में व्याख्या करता है — अप्रत्यक्ष प्रॉम्प्ट इंजेक्शन। एक अपहृत एजेंट को विनाशकारी टूल कॉल (हटाना / अप्रकाशित करना / अधिलेखित करना) या अप्रकाशित ड्राफ्ट लीक करने के लिए निर्देशित किया जा सकता है। यह एक उद्योग-व्यापी, अनसुलझी समस्या है जिसे सर्वर अपनी लौटाई गई सामग्री को बदलकर विश्वसनीय रूप से ठीक नहीं कर सकता, इसलिए सुरक्षा स्तरित है:

न्यूनतम-विशेषाधिकार वाली 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 - सामान्य त्रुटि फेंकने वाली उपयोगिता
- app.ts - स्ट्रीमेबल HTTP परिवहन के लिए Express ऐप फैक्ट्री
- 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