Cloudinary

npx add-mcp 'https://asset-management.mcp.cloudinary.com/mcp'

Cloudinary MCP सर्वर

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) बड़े भाषा मॉडल (LLMs) और बाहरी सिस्टम के बीच संदर्भ प्रबंधित करने के लिए एक नया, मानकीकृत प्रोटोकॉल है। यह रिपॉजिटरी Cloudinary के मीडिया प्रबंधन प्लेटफ़ॉर्म के लिए व्यापक MCP सर्वर प्रदान करती है, जिससे आप Cursor और Claude जैसे AI अनुप्रयोगों से सीधे प्राकृतिक भाषा का उपयोग करके अपनी मीडिया संपत्तियों को अपलोड, रूपांतरित, विश्लेषण और व्यवस्थित कर सकते हैं।

इन MCP सर्वरों के साथ, आप संवादात्मक AI के माध्यम से अपने संपूर्ण मीडिया वर्कफ़्लो को सहजता से प्रबंधित कर सकते हैं - छवियों और वीडियो को अपलोड करने और रूपांतरित करने से लेकर, स्वचालित प्रोसेसिंग पाइपलाइनों को कॉन्फ़िगर करने, AI-संचालित टूल के साथ सामग्री का विश्लेषण करने, और संरचित मेटाडेटा के साथ संपत्तियों को व्यवस्थित करने तक। चाहे आप मीडिया-समृद्ध अनुप्रयोग बना रहे हों, बड़े एसेट लाइब्रेरी प्रबंधित कर रहे हों, या सामग्री वर्कफ़्लो को स्वचालित कर रहे हों, ये सर्वर Cloudinary की मीडिया अनुकूलन और प्रबंधन क्षमताओं के पूर्ण सूट तक सीधी पहुँच प्रदान करते हैं।

Cloudinary के लिए निम्नलिखित MCP सर्वर उपलब्ध हैं:

सर्वर नाम	विवरण	रिमोट MCP सर्वर
एसेट प्रबंधन	उन्नत खोज और संगठन क्षमताओं के साथ अपनी मीडिया संपत्तियों को अपलोड, प्रबंधित और रूपांतरित करें	asset-management
पर्यावरण कॉन्फ़िगरेशन	अपनी Cloudinary पर्यावरण सेटिंग्स, अपलोड प्रीसेट और रूपांतरणों को कॉन्फ़िगर और प्रबंधित करें	environment-config
संरचित मेटाडेटा	बेहतर एसेट संगठन और खोज क्षमता के लिए संरचित मेटाडेटा फ़ील्ड बनाएं, प्रबंधित करें और क्वेरी करें	structured-metadata
विश्लेषण	अपनी मीडिया संपत्तियों के लिए AI-संचालित सामग्री विश्लेषण, मॉडरेशन और स्वचालित टैगिंग क्षमताओं का लाभ उठाएं	analysis
MediaFlows	AI-संचालित सहायता के साथ छवियों और वीडियो के लिए लो-कोड वर्कफ़्लो स्वचालन बनाएं और प्रबंधित करें	mediaflows

विषय-सूची

• दस्तावेज़ीकरण
• स्थापना
  • रिमोट MCP सर्वर (अनुशंसित)
  • स्थानीय MCP सर्वर
  • Docker छवियाँ
• कॉन्फ़िगरेशन उदाहरण
  • उन्नत स्थानीय सर्वर कॉन्फ़िगरेशन
• प्रमाणीकरण
• सर्वर द्वारा सुविधाएँ
• अधिक Cloudinary टूल तक पहुँच चाहिए?
• समस्या निवारण
• सशुल्क सुविधाएँ
• लाइसेंस

दस्तावेज़ीकरण

Cloudinary के MCP सर्वरों का उपयोग करने पर विस्तृत गाइड, ट्यूटोरियल और व्यापक दस्तावेज़ीकरण के लिए:

• Cloudinary MCP और LLM टूल दस्तावेज़ीकरण - Cloudinary को AI/LLM अनुप्रयोगों के साथ एकीकृत करने के लिए पूर्ण गाइड
• MediaFlows MCP दस्तावेज़ीकरण - MediaFlows (MCP) सर्वर का उपयोग करने के लिए सेटअप निर्देश और दिशानिर्देश

स्थापना

रिमोट MCP सर्वर (अनुशंसित)

रिमोट MCP सर्वर Cloudinary द्वारा होस्ट किए जाते हैं और तुरंत उपयोग के लिए तैयार होते हैं। किसी स्थानीय स्थापना की आवश्यकता नहीं है।

स्थानीय MCP सर्वर

स्थानीय MCP सर्वर npm पैकेजों का उपयोग करके आपकी मशीन पर चलते हैं। यदि आपको अधिक नियंत्रण या अनुकूलन की आवश्यकता है तो यह विकल्प चुनें।

नोट: स्थापना के बाद आपको अपने वास्तविक क्रेडेंशियल्स के साथ अपने पर्यावरण चर (CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET) को कॉन्फ़िगर करना होगा।

Docker छवियाँ

Cloudinary MCP सर्वरों के लिए आधिकारिक Docker छवियाँ Docker Hub पर उपलब्ध हैं, जो स्थानीय रूप से या क्लाउड वातावरण में MCP सर्वर चलाने के लिए एक कंटेनरीकृत तैनाती विकल्प प्रदान करती हैं।

Docker Hub पर उपलब्ध: Cloudinary MCP Docker छवियाँ

Docker छवियाँ कई लाभ प्रदान करती हैं:

• पृथक वातावरण - अपने सिस्टम निर्भरताओं को प्रभावित किए बिना कंटेनरों में MCP सर्वर चलाएं
• आसान तैनाती - न्यूनतम कॉन्फ़िगरेशन के साथ त्वरित सेटअप
• संगत रनटाइम - विभिन्न मशीनों और प्लेटफ़ॉर्मों पर समान वातावरण सुनिश्चित करता है
• स्केलेबिलिटी - आसानी से कई इंस्टेंस तैनात करें या कंटेनर ऑर्केस्ट्रेशन सिस्टम में एकीकृत करें

Docker छवियों का उपयोग करने के लिए, सुनिश्चित करें कि आपके सिस्टम पर Docker स्थापित है और कंटेनर चलाते समय अपने Cloudinary क्रेडेंशियल्स को पर्यावरण चर के रूप में पास करें। विशिष्ट उपयोग निर्देशों के लिए Docker Hub पर व्यक्तिगत Docker छवि दस्तावेज़ीकरण देखें।

कॉन्फ़िगरेशन उदाहरण

रिमोट MCP सर्वर कॉन्फ़िगरेशन

रिमोट सर्वर Cloudinary द्वारा होस्ट किए जाते हैं और URL के माध्यम से एक्सेस किए जाते हैं:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp"
    },
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp"
    },
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp"
    },
    "cloudinary-analysis-remote": {
      "url": "https://analysis.mcp.cloudinary.com/sse"
    },
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp"
    }
  }
}

ट्रांसपोर्ट: रिमोट सर्वर दो एंडपॉइंट का समर्थन करते हैं — /mcp (स्ट्रीमेबल HTTP, अनुशंसित, स्टेटलेस) और /sse (SSE, पदावनत, पिछड़ी संगतता के लिए रखा गया)। /sse एंडपॉइंट /mcp के लिए एक उपनाम के रूप में POST अनुरोधों को भी स्वीकार करता है, इसलिए जो क्लाइंट /sse पर स्ट्रीमेबल HTTP भेजते हैं वे काम करेंगे। नए कॉन्फ़िगरेशन के लिए /mcp का उपयोग करें।

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

Cloudinary द्वारा होस्ट किए गए रिमोट MCP सर्वर डिफ़ॉल्ट रूप से प्रमाणीकरण के लिए OAuth2 का उपयोग करते हैं। आप हेडर के माध्यम से API कुंजियों का उपयोग करके भी प्रमाणित कर सकते हैं:

CLOUDINARY_URL का उपयोग करना (सबसे सरल)

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

व्यक्तिगत हेडर का उपयोग करना

{
  "mcpServers": {
    "cloudinary-env-config-remote": {
      "url": "https://environment-config.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-cloud-name": "your_cloud_name",
        "cloudinary-api-key": "your_api_key",
        "cloudinary-api-secret": "your_api_secret"
      }
    }
  }
}

कस्टम कॉन्फ़िगरेशन के साथ

{
  "mcpServers": {
    "cloudinary-smd-remote": {
      "url": "https://structured-metadata.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-region": "api-eu",
        "cloudinary-tools": "list-metadata-fields,get-metadata-field,create-metadata-field"
      }
    }
  }
}

डीबग हेडर के साथ

टूल परिणामों में API दर-सीमा हेडर और अनुरोध आईडी सतह पर लाने के लिए, हेडर एम्बेडिंग सक्षम करें:

{
  "mcpServers": {
    "cloudinary-asset-mgmt-remote": {
      "url": "https://asset-management.mcp.cloudinary.com/mcp",
      "headers": {
        "cloudinary-url": "cloudinary://api_key:api_secret@cloud_name",
        "cloudinary-embed-headers": "true"
      }
    }
  }
}

प्रत्येक टूल परिणाम में दर-सीमा और अनुरोध ट्रेसिंग जानकारी के साथ एक _headers फ़ील्ड शामिल होगी:

{
  "_headers": {
    "x-featureratelimit-limit": "10000",
    "x-featureratelimit-remaining": "9998",
    "x-featureratelimit-reset": "Thu, 13 Feb 2026 00:00:00 GMT",
    "x-request-id": "bfeaccc60050594832508590a358a1a4"
  }
}

स्थानीय MCP सर्वर कॉन्फ़िगरेशन

स्थानीय सर्वर npm पैकेजों का उपयोग करके आपकी मशीन पर चलते हैं:

विकल्प 1: CLOUDINARY_URL पर्यावरण चर का उपयोग करना (अनुशंसित)

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-env-config": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/environment-config-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-smd": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/structured-metadata-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    },
    "cloudinary-analysis": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/analysis", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_URL": "cloudinary://api_key:api_secret@cloud_name"
      }
    }
  }
}

विकल्प 2: व्यक्तिगत पर्यावरण चर का उपयोग करना

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": ["-y", "--package", "@cloudinary/asset-management-mcp", "--", "mcp", "start"],
      "env": {
        "CLOUDINARY_CLOUD_NAME": "cloud_name",
        "CLOUDINARY_API_KEY": "api_key",
        "CLOUDINARY_API_SECRET": "api_secret"
      }
    }
  }
}

विकल्प 3: कमांड लाइन तर्कों का उपयोग करना

{
  "mcpServers": {
    "cloudinary-asset-mgmt": {
      "command": "npx",
      "args": [
        "-y", "--package", "@cloudinary/asset-management-mcp",
        "--",
        "mcp", "start",
        "--cloud-name", "cloud_name",
        "--api-key", "api_key",
        "--api-secret", "api_secret"
      ]
    }
  }
}

MediaFlows MCP सर्वर कॉन्फ़िगरेशन

MediaFlows के लिए, निम्नलिखित कॉन्फ़िगरेशन का उपयोग करें:

{
  "mcpServers": {
    "mediaflows": {
      "url": "https://mediaflows.mcp.cloudinary.com/v2/mcp",
      "headers": {
        "cld-cloud-name": "cloud_name",
        "cld-api-key": "api_key",
        "cld-secret": "api_secret"
      }
    }
  }
}

उन्नत स्थानीय सर्वर कॉन्फ़िगरेशन

प्रत्येक npm पैकेज ऊपर दिए गए बुनियादी सेटअप उदाहरणों से परे अतिरिक्त कॉन्फ़िगरेशन विकल्पों का समर्थन करता है।

SSE सर्वर के रूप में चलाना

stdio के बजाय सर्वर-सेंट इवेंट्स (SSE) ट्रांसपोर्ट का उपयोग करके स्थानीय MCP सर्वर चलाने के लिए:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse

आप एक कस्टम पोर्ट निर्दिष्ट कर सकते हैं (डिफ़ॉल्ट 2718 है):

npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --port 3000

उपलब्ध कॉन्फ़िगरेशन विकल्प

किसी भी पैकेज के लिए सभी उपलब्ध कॉन्फ़िगरेशन विकल्प देखने के लिए:

npx -y --package @cloudinary/asset-management-mcp -- mcp start --help

उपलब्ध फ़्लैग की पूरी सूची:

USAGE
  mcp start [--transport stdio|sse] [--port value] [--tool value]...
            [--scope admin|builder|librarian] [--api-key value]
            [--api-secret value] [--oauth2 value] [--cloud-name value]
            [--server-url value] [--server-index value]
            [--region api|api-eu|api-ap] [--api-host value]
            [--log-level debug|warning|info|error] [--env value]...

FLAGS
  --transport       The transport to use for communicating with the server
                    [stdio|sse, default = stdio]
  --port            The port to use when the SSE transport is enabled
                    [default = 2718]
  --tool...         Specify tools to mount on the server (repeatable)
  --scope           Mount tools/resources that match given scope
                    [admin|builder|librarian]
  --api-key         Sets the apiKey auth field for the API
  --api-secret      Sets the apiSecret auth field for the API
  --oauth2          Sets the oauth2 auth field for the API
  --cloud-name      Allows setting the cloudName parameter for all operations
  --server-url      Overrides the default server URL used by the SDK
  --server-index    Selects a predefined server used by the SDK
  --region          Sets the region variable for url substitution
                    [api|api-eu|api-ap]
  --api-host        Sets the host variable for url substitution
  --log-level       The log level to use for the server
                    [debug|warning|info|error, default = info]
  --env...          Environment variables made available to the server
  -h, --help        Print help information and exit

डीबगिंग

विस्तृत नेटवर्क पेलोड डीबगिंग के लिए, CLOUDINARY_DEBUG पर्यावरण चर का उपयोग करें:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start

आप व्यापक समस्या निवारण के लिए डीबग मोड को अन्य विकल्पों के साथ जोड़ सकते हैं:

CLOUDINARY_DEBUG=true npx -y --package @cloudinary/asset-management-mcp -- mcp start --transport sse --log-level debug

नोट: ये कॉन्फ़िगरेशन विकल्प सभी स्थानीय MCP पैकेजों पर लागू होते हैं:

• @cloudinary/asset-management-mcp
• @cloudinary/environment-config-mcp
• @cloudinary/structured-metadata-mcp
• @cloudinary/analysis

प्रमाणीकरण

स्थानीय रूप से MCP सर्वर चलाते समय, प्रमाणीकरण कई तरीकों से कॉन्फ़िगर किया जा सकता है:

विकल्प 1: व्यक्तिगत पर्यावरण चर (अनुशंसित)

export CLOUDINARY_CLOUD_NAME="cloud_name"
export CLOUDINARY_API_KEY="api_key"
export CLOUDINARY_API_SECRET="api_secret"

विकल्प 2: CLOUDINARY_URL पर्यावरण चर

export CLOUDINARY_URL="cloudinary://api_key:api_secret@cloud_name"

विकल्प 3: कमांड लाइन तर्क

क्रेडेंशियल्स को सीधे तर्कों के रूप में पास करें (ऊपर कॉन्फ़िगरेशन उदाहरण देखें)

आप अपने Cloudinary क्रेडेंशियल्स अपने Cloudinary कंसोल डैशबोर्ड में सेटिंग्स > सुरक्षा के अंतर्गत पा सकते हैं।

सर्वर द्वारा सुविधाएँ

एसेट प्रबंधन सर्वर

• मीडिया संपत्तियों (छवियाँ, वीडियो, कच्ची फ़ाइलें) को अपलोड और प्रबंधित करें
• उन्नत फ़िल्टरिंग क्षमताओं के साथ संपत्तियों को खोजें और व्यवस्थित करें
• एसेट संचालन और रूपांतरणों को संभालें
• फ़ोल्डर, टैग और एसेट संबंधों का प्रबंधन करें
• संग्रह और डाउनलोड लिंक उत्पन्न करें

पर्यावरण कॉन्फ़िगरेशन सर्वर

• अपलोड प्रीसेट और रूपांतरण सेटिंग्स कॉन्फ़िगर करें
• स्ट्रीमिंग प्रोफ़ाइल और वेबहुक सूचनाएं प्रबंधित करें
• अपलोड मैपिंग सेट करें

संरचित मेटाडेटा सर्वर

• संरचित मेटाडेटा फ़ील्ड बनाएं और प्रबंधित करें
• सशर्त मेटाडेटा नियम और सत्यापन कॉन्फ़िगर करें
• मेटाडेटा कॉन्फ़िगरेशन व्यवस्थित और खोजें
• मेटाडेटा फ़ील्ड संबंधों और क्रम को संभालें

विश्लेषण सर्वर

• टैगिंग, मॉडरेशन और कैप्शनिंग सहित AI-संचालित सामग्री विश्लेषण
• कई AI मॉडलों के साथ ऑब्जेक्ट डिटेक्शन और पहचान
• छवि गुणवत्ता विश्लेषण और वॉटरमार्क डिटेक्शन
• सामग्री मॉडरेशन और सुरक्षा विश्लेषण
• फैशन, पाठ और शारीरिक रचना डिटेक्शन क्षमताएँ

MediaFlows सर्वर

• प्राकृतिक भाषा का उपयोग करके वर्कफ़्लो स्वचालन बनाएं और प्रबंधित करें
• अपने पर्यावरण में मौजूदा PowerFlow स्वचालन क्वेरी करें
• मेटाडेटा, टैग और एसेट गुणों के आधार पर सशर्त तर्क बनाएं
• एसेट मॉडरेशन, अनुमोदन और सूचना वर्कफ़्लो स्वचालित करें
• मौजूदा स्वचालन कॉन्फ़िगरेशन को डीबग और समझें

अधिक Cloudinary टूल तक पहुँच चाहिए?

हम इन MCP सर्वरों में अधिक कार्यक्षमता जोड़ते रहते हैं। यदि आप प्रतिक्रिया देना चाहते हैं, बग दर्ज करना चाहते हैं या सुविधा अनुरोध प्रदान करना चाहते हैं, तो कृपया इस रिपॉजिटरी पर एक मुद्दा खोलें।

समस्या निवारण

"क्लॉड की प्रतिक्रिया बाधित हुई..."

यदि आप यह संदेश देखते हैं, तो क्लॉड संभवतः अपनी संदर्भ-लंबाई सीमा तक पहुँच गया और उत्तर के बीच में रुक गया। यह अक्सर उन सर्वरों पर होता है जो कई श्रृंखलाबद्ध टूल कॉल ट्रिगर करते हैं जैसे कि बड़ी एसेट सूचियों वाला एसेट प्रबंधन सर्वर।

इस समस्या का सामना करने की संभावना कम करने के लिए:

• विशिष्ट रहें, अपनी क्वेरी संक्षिप्त रखें।
• यदि एक अनुरोध कई टूल कॉल करता है, तो प्रतिक्रियाओं को छोटा रखने के लिए इसे कई छोटे टूल कॉल में विभाजित करने का प्रयास करें।
• एसेट खोजों और सूचियों के दायरे को सीमित करने के लिए फ़िल्टरिंग पैरामीटर का उपयोग करें।

प्रमाणीकरण समस्याएँ

सुनिश्चित करें कि आपके Cloudinary क्रेडेंशियल्स सही ढंग से कॉन्फ़िगर किए गए हैं और आपके द्वारा किए जाने वाले संचालन के लिए आवश्यक अनुमतियाँ हैं।

सशुल्क सुविधाएँ

कुछ सुविधाओं के लिए सशुल्क Cloudinary योजना की आवश्यकता हो सकती है। सुनिश्चित करें कि आपके Cloudinary खाते में उन सुविधाओं के लिए आवश्यक सदस्यता स्तर है जिनका आप उपयोग करना चाहते हैं, जैसे:

• उन्नत AI विश्लेषण सुविधाएँ
• उच्च-मात्रा API उपयोग
• उन्नत रूपांतरण क्षमताएँ

लाइसेंस

MIT लाइसेंस के तहत लाइसेंस प्राप्त। विवरण के लिए LICENSE फ़ाइल देखें।