DevHub MCP Server

DevHub CMS MCP

DevHub CMS सिस्टम में सामग्री प्रबंधन के लिए एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) एकीकरण।

इंस्टॉलेशन

आपको अपने स्थानीय सिस्टम पर uv पैकेज मैनेजर इंस्टॉल करना होगा।

Claude Desktop का मैन्युअल कॉन्फ़िगरेशन

Claude Desktop ऐप के साथ इस सर्वर का उपयोग करने के लिए, अपने claude_desktop_config.json के "mcpServers" अनुभाग में निम्नलिखित कॉन्फ़िगरेशन जोड़ें:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uvx",
            "args": [
                "devhub-cms-mcp"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

कॉन्फ़िगरेशन अपडेट करने के बाद, Claude Desktop को पुनः आरंभ करें।

Cursor के लिए मैन्युअल कॉन्फ़िगरेशन

इस MCP का उपयोग Cursor में भी किया जा सकता है, ऊपर दिए गए समान कॉन्फ़िगरेशन को अपने Cursor वैश्विक वातावरण या व्यक्तिगत परियोजनाओं में जोड़कर।

उदाहरण यहाँ

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

Claude Code की कमांड लाइन MCP इंस्टॉल का समर्थन करती है।

आप नीचे दिए गए एनवायरनमेंट वेरिएबल्स को अपडेट करके devhub-cms-mcp जोड़ सकते हैं

claude mcp add devhub-cms-mcp \
    -e DEVHUB_API_KEY=YOUR_KEY_HERE \
    -e DEVHUB_API_SECRET=YOUR_SECRET_HERE \
    -e DEVHUB_BASE_URL=https://yourbrand.cloudfrontend.net \
    -- uvx devhub-cms-mcp

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

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

npx -y @smithery/cli install @devhub/devhub-cms-mcp --client claude

स्थानीय विकास

रेपो (या अपने फोर्क) को क्लोन करें

git clone [email protected]:devhub/devhub-cms-mcp.git

Claude Desktop का मैन्युअल कॉन्फ़िगरेशन

स्थानीय विकास के लिए Claude Desktop ऐप के साथ इस सर्वर का उपयोग करने के लिए, अपने claude_desktop_config.json के "mcpServers" अनुभाग में निम्नलिखित कॉन्फ़िगरेशन जोड़ें:

{
    "mcpServers": {
        "devhub_cms_mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/YOUR/LOCAL/PATH/devhub-cms-mcp/",
                "run",
                "main.py"
            ],
            "env": {
                "DEVHUB_API_KEY": "YOUR_KEY_HERE",
                "DEVHUB_API_SECRET": "YOUR_SECRET_HERE",
                "DEVHUB_BASE_URL": "https://yourbrand.cloudfrontend.net"
            }
        }
    }
}

कॉन्फ़िगरेशन अपडेट करने के बाद, Claude Desktop को पुनः आरंभ करें।

uv के साथ सीधे चलाने के लिए कॉन्फ़िगरेशन

इस MCP के लिए निम्नलिखित एनवायरनमेंट वेरिएबल्स सेट करना आवश्यक है:

export DEVHUB_API_KEY="your_api_key"
export DEVHUB_API_SECRET="your_api_secret"
export DEVHUB_BASE_URL="https://yourbrand.cloudfrontend.net"

फिर MCP चलाएँ

uv run main.py

उपलब्ध उपकरण

यह MCP DevHub CMS के साथ इंटरैक्ट करने के लिए निम्नलिखित उपकरण प्रदान करता है:

व्यवसाय और स्थान प्रबंधन

• get_businesses(): DevHub खाते के अंतर्गत सभी व्यवसायों को प्राप्त करता है। उनके IDs और नामों के साथ व्यवसायों की सूची लौटाता है।
• get_locations(business_id): किसी विशिष्ट व्यवसाय के लिए सभी स्थानों को प्राप्त करता है। पता, निर्देशांक और URL सहित विस्तृत स्थान जानकारी लौटाता है।
• get_hours_of_operation(location_id, hours_type='primary'): किसी विशिष्ट DevHub स्थान के संचालन के घंटे प्राप्त करता है। सप्ताह के प्रत्येक दिन के लिए समय सीमाओं की एक संरचित सूची लौटाता है।
• update_hours(location_id, new_hours, hours_type='primary'): DevHub स्थान के संचालन के घंटे अपडेट करता है।
• get_nearest_location(business_id, latitude, longitude): भौगोलिक निर्देशांकों के आधार पर निकटतम DevHub स्थान ढूंढता है।
• site_from_url(url): किसी URL से DevHub साइट ID और विवरण प्राप्त करता है। साइट ID, URL और संबंधित स्थान IDs लौटाता है।

सामग्री प्रबंधन

• get_blog_post(post_id): ID द्वारा एकल ब्लॉग पोस्ट प्राप्त करता है, जिसमें उसका शीर्षक, दिनांक और HTML सामग्री शामिल है।
• create_blog_post(site_id, title, content): एक नई ब्लॉग पोस्ट बनाता है। सामग्री HTML प्रारूप में होनी चाहिए और इसमें H1 टैग शामिल नहीं होना चाहिए।
• update_blog_post(post_id, title=None, content=None): किसी मौजूदा ब्लॉग पोस्ट के शीर्षक और/या सामग्री को अपडेट करता है।

मीडिया प्रबंधन

• upload_image(base64_image_content, filename): DevHub मीडिया गैलरी में एक छवि अपलोड करता है। webp, jpeg और png प्रारूपों का समर्थन करता है। छवि को base64-एन्कोडेड स्ट्रिंग के रूप में प्रदान किया जाना चाहिए।

LLMs के साथ उपयोग

यह MCP उन बड़े भाषा मॉडलों के साथ उपयोग के लिए डिज़ाइन किया गया है जो मॉडल कॉन्टेक्स्ट प्रोटोकॉल का समर्थन करते हैं। यह LLMs को DevHub CMS में सामग्री प्रबंधित करने की अनुमति देता है बिना LLM में मूल रूप से एकीकृत सीधे API एक्सेस की आवश्यकता के।

परीक्षण

इस पैकेज में DevHub API के लिए नकली अनुरोधों के साथ एक परीक्षण सूट शामिल है, जो आपको वास्तविक API कॉल किए बिना कार्यक्षमता का परीक्षण करने की अनुमति देता है।

परीक्षण चलाना

परीक्षण चलाने के लिए, पहले परीक्षण निर्भरताओं के साथ पैकेज इंस्टॉल करें:

uv pip install -e ".[test]"

pytest के साथ परीक्षण चलाएँ:

uv run pytest

अधिक विस्तृत आउटपुट और परीक्षण कवरेज जानकारी के लिए:

uv run pytest -v --cov=devhub_cms_mcp

परीक्षण संरचना

• tests/devhub_cms_mcp/test_mcp_integration.py: MCP एकीकरण एंडपॉइंट्स के लिए परीक्षण