Replicate MCP Server: Claude, Claude Code और Cursor से मॉडल चलाएँ

अब आप Claude से कह सकते हैं कि Replicate पर कोई इमेज मॉडल खोजे, आपके प्रॉम्प्ट के साथ उसे चलाए और तैयार फ़ाइल चैट छोड़े बिना वापस दे दे। Replicate MCP server का यही मकसद है। यह Replicate के HTTP API को किसी भी ऐसे क्लाइंट से जोड़ देता है जो Model Context Protocol समझता है, इसलिए Claude Desktop, Claude Code और Cursor हज़ारों मॉडल खोज सकते हैं और आपकी ओर से प्रेडिक्शन बना सकते हैं।

सेटअप में लगभग पाँच मिनट लगते हैं। लोगों को असली रुकावट छोटी बातों से होती है: कौन सा URL डालना है, कौन सा ट्रांसपोर्ट चुनना है, टोकन कहाँ जाएगा, और बाद में बिल पर क्या दिखेगा। नीचे आपको हर क्लाइंट के लिए सटीक कमांड, टोकन सुरक्षा की चेकलिस्ट, प्रयोगात्मक कोड मोड की जानकारी और उन पाठकों के लिए बिना सेटअप वाला रास्ता मिलेगा जिन्हें बस तैयार इमेज और वीडियो चाहिए।

Replicate MCP Server क्या करता है

Replicate इमेज, वीडियो, ऑडियो और टेक्स्ट मॉडल का एक बड़ा कैटलॉग एक ही API के पीछे रखता है। आधिकारिक MCP server उस API को टूल्स के रूप में पेश करता है, ताकि असिस्टेंट सीधे उसे कॉल कर सके और आपको curl कमांड या ब्राउज़र टैब के बीच भागदौड़ न करनी पड़े। Replicate के डॉक्स के अनुसार यह Replicate के HTTP API के सभी ऑपरेशन सपोर्ट करता है: खोजना, मॉडल की सूची देखना और उनकी जानकारी लेना, फिर प्रेडिक्शन बनाना और उन्हें वापस लाना।

प्रॉम्प्ट कैसे प्रेडिक्शन बनता है

मान लीजिए आप लिखते हैं: सुबह के समय एक लाइटहाउस की 16:9 फ़ोटो बनाओ। क्लाइंट आपका संदेश लार्ज लैंग्वेज मॉडल को भेजता है, मॉडल तय करता है कि उसे इमेज टूल चाहिए, और वह server को कॉल करता है। Server अनुरोध Replicate तक पहुँचाता है, जो चुने हुए मॉडल को अपने GPU पर चलाता है और आउटपुट URL लौटाता है। क्रम आम तौर पर ऐसा दिखता है:

1. असिस्टेंट काम के लिए फ़िट बैठने वाला मॉडल खोजता है।
2. वह उस मॉडल के इनपुट विकल्प पढ़ता है, जैसे प्रॉम्प्ट फ़ील्ड और आस्पेक्ट रेशियो।
3. वह आपके प्रॉम्प्ट और सेटिंग्स के साथ प्रेडिक्शन बनाता है।
4. वह नतीजा लाता है और आपको आउटपुट लिंक दिखाता है।

💡 टिप: अगर आप जिस मॉडल को चाहते हैं वह पहले से जानते हैं, तो उसका नाम प्रॉम्प्ट में लिख दें। इससे खोज वाला चरण छूट जाता है और हर सेशन में नतीजे दोहराए जाने लायक रहते हैं।

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

आपको कौन से टूल मिलते हैं

Replicate का MCP पेज तीन टूल बताता है, और डॉक्स उनके नीचे के ऑपरेशन सूचीबद्ध करते हैं:

हार्डवेयर मायने रखता है, क्योंकि उससे स्पीड और कीमत दोनों तय होते हैं, इसलिए किसी बड़े बैच से पहले list_hardware आज़माना उपयोगी है।

होस्टेड या लोकल सेटअप

आप server को दो तरीकों से चला सकते हैं, और चुनाव ही तय करता है कि ऑथेंटिकेशन कैसे होगा।

जब तक आपके पास अपनी मशीन पर प्रोसेस चलाने की कोई वजह न हो, होस्टेड server चुनें। यह आपके सेटअप से टोकन फ़ाइल को पूरी तरह हटा देता है, और अगले भागों के सभी उदाहरण इसी रास्ते से शुरू होते हैं।

⚠️ ध्यान दें: पुराने ट्यूटोरियल आपसे mcp-replicate इंस्टॉल करने को कहते हैं। वह एक कम्युनिटी प्रयोग था, और उसके README में लिखा है कि उस पर अब सक्रिय विकास नहीं हो रहा। आधिकारिक server ने उसकी जगह ले ली है, इसलिए पुराने पैकेज को छोड़ दें।

mcp.replicate.com पर होस्टेड server

Replicate जिस server की सिफ़ारिश करता है वह यही है। क्लाइंट SSE endpoint, https://mcp.replicate.com/sse, से कनेक्ट होते हैं, और आख़िर में एक वेब-आधारित अप्रूवल चरण आता है जहाँ आप Replicate API टोकन डालते हैं। शुरू करने से पहले replicate.com/account/api-tokens पर एक टोकन बनाएँ और उसे क्लिपबोर्ड पर रखें।

npx के साथ लोकल server

लोकल विकल्प वही server आपकी मशीन पर एक प्रोसेस के रूप में चलाता है। REPLICATE_API_TOKEN सेट करें, npx -y replicate-mcp से उसे शुरू करें और Ctrl+C से रोकें। ज़्यादातर क्लाइंट इसे ऐसी कॉन्फ़िग फ़ाइल से अपने आप लॉन्च कर देते हैं:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "replicate-mcp"],
      "env": {
        "REPLICATE_API_TOKEN": "your-token-here"
      }
    }
  }
}

प्रॉम्प्ट कॉपी करें

GitHub Copilot वाला VS Code .vscode/mcp.json पढ़ता है और mcpServers की जगह एक टॉप-लेवल servers ऑब्जेक्ट इस्तेमाल करता है, इसलिए ब्लॉक कॉपी करें और बस वह एक फ़ील्ड बदल दें। अगर server कभी दिखाई न दे, तो जाँचें कि Node इंस्टॉल है और npx एक सामान्य टर्मिनल से चलता है।

Claude Desktop से जोड़ें

Claude Desktop सबसे तेज़ रास्ता है, क्योंकि होस्टेड server को किसी कॉन्फ़िग फ़ाइल की ज़रूरत ही नहीं होती।

कस्टम कनेक्टर जोड़ें

1. Settings खोलें और Connectors पर जाएँ।
2. Add Custom Connector पर क्लिक करें।
3. server का URL डालें: https://mcp.replicate.com/sse।
4. Connect पर क्लिक करें और अपना Replicate API टोकन डालें।
5. Log in and Approve पर क्लिक करें।
6. Claude Desktop को रीस्टार्ट करें। चैट इनपुट के नीचे स्लाइडर आइकन के अंतर्गत टूल दिखाई देंगे।

लोकल server पसंद है? पिछले भाग का JSON claude_desktop_config.json में डालें और ऐप रीस्टार्ट करें।

आज़माने के लिए पहला प्रॉम्प्ट

कुछ ऐसे से शुरू करें जो खोज, जाँच और रन का पूरा लूप चलाने पर मजबूर करे:

Replicate पर एक तेज़ फ़ोटोरियलिस्टिक टेक्स्ट-टू-इमेज मॉडल खोजें, उसके इनपुट विकल्प दिखाएँ, फिर सुबह के समय लाइटहाउस की 16:9 फ़ोटो बनाएँ।

FLUX Schnell जैसे तेज़ FLUX वर्ज़न ऐसे अनुरोध के लिए आम उम्मीदवार हैं, हालाँकि पहले कौन सा आएगा यह खोज तय करती है। अगर जवाब इनलाइन तस्वीर की जगह लिंक के रूप में आए, तो यह सामान्य है: server आउटपुट URL लौटाता है, और यह तय करना क्लाइंट का काम है कि उसे कैसे दिखाए।

एक बार यह काम कर जाए, तो साफ़-साफ़ बताएँ। आस्पेक्ट रेशियो, लेंस, रोशनी की दिशा और कितने वेरिएशन चाहिए, यह सब लिखें। अस्पष्ट प्रॉम्प्ट रन बर्बाद करते हैं, और हर रन का बिल बनता है।

Claude Code से जोड़ें

Claude Code के लिए एक ही कमांड काफ़ी है, और यह कनेक्शन कई प्रोजेक्ट्स में बना रहता है।

एक कमांड से इंस्टॉल

अगर CLI अभी इंस्टॉल नहीं है, तो उसे इंस्टॉल करें, फिर server जोड़ें:

npm install -g @anthropic-ai/claude-code
claude mcp add replicate https://mcp.replicate.com/sse --transport sse --scope user

प्रॉम्प्ट कॉपी करें

--scope user फ़्लैग server को आपकी यूज़र कॉन्फ़िगरेशन में सेव करता है, इसलिए आप जो भी प्रोजेक्ट खोलेंगे उसे इसकी पहुँच मिल जाएगी।

/mcp से ऑथेंटिकेट करें

claude लॉन्च करें, /mcp टाइप करें, Replicate वाली एंट्री चुनें, और वही अप्रूवल फ़्लो वाली ब्राउज़र विंडो खुलेगी जो Claude Desktop इस्तेमाल करता है। जैसे ही वह कनेक्टेड दिखाए, सादी भाषा में रन माँगें।

क्योंकि Claude Code आपके रिपॉज़िटरी के अंदर काम करता है, वह सिर्फ़ लिंक दिखाने से ज़्यादा कर सकता है। यह आज़माएँ: लैंडिंग पेज के लिए तीन हीरो इमेज विकल्प बनाओ, फिर हर आउटपुट को public/images में डाउनलोड करो। डाउनलोड वाला चरण दिखने से ज़्यादा मायने रखता है, और नीचे का खर्च वाला भाग बताता है क्यों।

अगर टूल दिखाई न दें, तो /mcp फिर से चलाएँ और स्टेटस लाइन में server की स्थिति देखें। जो server disconnected दिखाता है उसे आम तौर पर नए ऑथेंटिकेशन की ज़रूरत होती है, दोबारा इंस्टॉल की नहीं।

Cursor से जोड़ें

Cursor MCP servers एक JSON फ़ाइल से पढ़ता है, इसलिए यह सेटअप कुछ लाइनों की कॉन्फ़िग है।

mcp.json फ़ाइल एडिट करें

Cursor Settings खोलें, Tools & Integrations पर जाएँ और New MCP Server पर क्लिक करें। Cursor ~/.cursor/mcp.json खोलता है, जहाँ आप mcp-remote ब्रिज के ज़रिए होस्टेड server जोड़ते हैं:

{
  "mcpServers": {
    "replicate": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.replicate.com/sse"]
    }
  }
}

प्रॉम्प्ट कॉपी करें

एक ही रिपॉज़िटरी के लिए प्रोजेक्ट में .cursor/mcp.json बनाएँ, और ऊपर वाला लोकल-server JSON इस्तेमाल करें, जिसमें अपना टोकन env में रखें। फ़ाइल सेव करें, और server उसके टूल्स समेत उसी सेटिंग्स पैनल में दिखना चाहिए।

इसके बाद Cursor का एजेंट, जब भी वह उस कंपोनेंट को एडिट करता है जिसे उनकी ज़रूरत है, प्लेसहोल्डर आर्ट, प्रोडक्ट शॉट या आइकन बना सकता है। असली फ़ायदा यही है: एसेट और कोड का बदलाव एक ही बातचीत में हो जाता है।

और क्लाइंट जो काम करते हैं

यही server इन तीन से आगे भी काम करता है:

• ब्राउज़र में Claude.ai
• Codex CLI
• Google Gemini CLI
• Windsurf
• Chorus
• GitHub Copilot वाला VS Code, जिसमें .vscode/mcp.json इस्तेमाल होता है

पैटर्न कभी नहीं बदलता: क्लाइंट को होस्टेड URL की ओर इंगित करें या replicate-mcp को लोकली लॉन्च करें, फिर एक बार ऑथेंटिकेट करें।

टोकन, खर्च और Code Mode

तीन बातें तय करती हैं कि यह सेटअप सुविधाजनक बना रहेगा या नहीं: आप टोकन को कैसे संभालते हैं, हर रन की लागत कितनी है, और ऑटोमेशन को कितनी दूर तक ले जाते हैं।

अपने टोकन की सुरक्षा करें

• टोकन replicate.com/account/api-tokens पर बनाएँ और उसे पासवर्ड की तरह संभालें।
• जहाँ हो सके होस्टेड फ़्लो चुनें। टोकन अप्रूवल स्क्रीन से गुज़रता है, न कि आपके रिपॉज़िटरी की किसी फ़ाइल में पड़ा रहता है।
• लोकल server के साथ टोकन को एनवायरनमेंट वेरिएबल में रखें, या कॉन्फ़िग फ़ाइल को वर्ज़न कंट्रोल से बाहर रखें। जब भी .cursor/mcp.json या .vscode/mcp.json में टोकन हो, उसे .gitignore में जोड़ें।
• अगर टोकन किसी कमिट, स्क्रीनशॉट या शेयर की गई चैट में दिख जाए, तो उसे तुरंत बदल दें।

आप किस चीज़ का भुगतान करते हैं

MCP server उसी API का एक दरवाज़ा है, इसलिए हर प्रेडिक्शन किसी भी दूसरी API कॉल की तरह आपके Replicate अकाउंट पर बिल होता है। कीमत मॉडल और उस हार्डवेयर पर निर्भर करती है जिस पर वह चलता है, इसीलिए किसी बड़े बैच से पहले list_hardware और मॉडल पेज पर एक नज़र डालना मददगार है।

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

💡 टिप: API प्रेडिक्शन के आउटपुट URL लगभग एक घंटे बाद गायब हो जाते हैं। असिस्टेंट से कहें कि हर नतीजा तुरंत डाउनलोड या अपलोड करे, खासकर लंबे सेशन में।

Deno सैंडबॉक्स में Code Mode

Replicate एक प्रयोगात्मक code mode भी देता है। एक-एक करके टूल कॉल करने के बजाय मॉडल TypeScript लिखता है और उसे Deno सैंडबॉक्स के अंदर चलाता है। यह उन कामों के लिए ठीक है जिनमें कई प्रेडिक्शन एक के बाद एक जुड़ते हैं, जैसे छह वेरिएशन बनाना और उनमें से सबसे अच्छे दो रखना। इसके लिए Deno इंस्टॉल होना चाहिए। इसे Claude Code में इस कमांड से जोड़ें:

claude mcp add "replicate-code-mode" --scope user --transport stdio -- npx -y replicate-mcp@alpha --tools=code

प्रॉम्प्ट कॉपी करें

@alpha टैग बताता है कि क्या उम्मीद रखें। इसे एक टेस्टिंग ग्राउंड की तरह देखें, नियमित server को उसके साथ इंस्टॉल रखें, और प्रोडक्शन काम में भरोसा करने से पहले उसका आउटपुट जाँच लें।

PicassoIA पर बिना सेटअप वाला विकल्प

अगर आपको सिर्फ़ तैयार इमेज या क्लिप चाहिए, कॉन्फ़िगरेशन में पूरी दोपहर लगाने की ज़रूरत नहीं, तो PicassoIA सैकड़ों मॉडल ब्राउज़ करने योग्य पेजों पर रखता है, और वहाँ कोई टोकन डालना नहीं पड़ता। प्रॉम्प्ट का मसौदा बनाने के लिए Claude Sonnet 5 जैसे LLM के साथ इसे इस्तेमाल करें, फिर ब्राउज़र में जेनरेट करें।

PicassoIA Image कैसे इस्तेमाल करें

PicassoIA Image प्लेटफ़ॉर्म का अपना टेक्स्ट-टू-इमेज मॉडल है, और कुछ भी ऑटोमेट करने से पहले प्रॉम्प्ट आज़माने की यह एक तेज़ जगह है।

1. PicassoIA Image मॉडल पेज खोलें।
2. एक प्रॉम्प्ट लिखें जिसमें सब्जेक्ट, सेटिंग, रोशनी की दिशा और लेंस हो, जैसे सुबह के समय एक लाइटहाउस, लो-एंगल, बाईं ओर से नरम गोल्डन आवर रोशनी, 35mm लेंस, फ़िल्म ग्रेन।
3. जो आस्पेक्ट रेशियो चाहिए वह चुनें, जैसे ब्लॉग हेडर के लिए 16:9।
4. जेनरेट करें, नतीजा देखें, और एक बार में एक ही डिटेल बदलें।
5. सबसे अच्छे नतीजे को PicassoIA Image Editor Pro पर भेजें, किसी ऑब्जेक्ट को बदलने या कोई डिटेल ठीक करने जैसे एडिट के लिए।
6. PicassoIA Video से उसे एनिमेट करें, जो टेक्स्ट या इमेज लेता है, या 10 सेकंड तक की क्लिप के लिए Seedance 2.5 Lite आज़माएँ।

💡 टिप: हर रन में एक ही वेरिएबल बदलें। जब नतीजा बेहतर हो, तो आपको पता रहेगा कि किस बदलाव से फ़र्क आया।

PicassoIA API और MCP

PicassoIA एक Replicate जैसा REST API भी देता है, इसलिए जो create, poll और fetch पैटर्न आपने अभी सेट किया, वह परिचित लगेगा:

• Base URL: https://api.picassoia.com/v1, जो आपके अकाउंट के Bearer टोकन से ऑथेंटिकेट होता है
• रन बनाएँ: POST /v1/models/{owner}/{name}/predictions
• रन जाँचें: GET /v1/predictions/{id}
• रन रद्द करें: POST /v1/predictions/{id}/cancel

API और MCP कनेक्शन के ज़रिए चार मॉडल उपलब्ध हैं: PicassoIA Image, PicassoIA Image Editor Pro, PicassoIA Video और Seedance 2.5 Lite। हर अकाउंट को 5 एक-साथ चलने वाले प्रेडिक्शन मिलते हैं, जो सभी टोकन और MCP कनेक्शन में साझा होते हैं, और प्रॉम्प्ट 4,000 अक्षर तक के हो सकते हैं। API और MCP की पहुँच आपके प्लान पर निर्भर करती है, इसलिए उस पर कुछ बनाने से पहले प्राइसिंग पेज देख लें, और डॉक्स picassoia.com/en/api पर पढ़ें।

आज ही अपनी पहली इमेज बनाएँ

अपने दिन के हिसाब से रास्ता चुनें। अगर आप टर्मिनल या एडिटर में काम करते हैं, तो अपने क्लाइंट की कमांड से Replicate MCP server जोड़ें और लाइटहाउस वाला प्रॉम्प्ट चलाएँ। अगर अगले साठ सेकंड में नतीजा चाहिए, तो PicassoIA खोलें और वहाँ वही प्रॉम्प्ट आज़माएँ। दोनों चलाएँ, नतीजों की तुलना करें, और जो आपके वर्कफ़्लो में फ़िट बैठे उसे रखें, या हर एक को उसके सबसे अच्छे काम के लिए इस्तेमाल करें।

PicassoIA Image पर आज़माने के लिए तीन प्रॉम्प्ट, जो इतने छोटे हैं कि आसानी से पेस्ट हो जाएँ:

• सूर्योदय के समय एक मछली पकड़ने वाली नाव, लो-एंगल, गीली लकड़ी की बनावट, 35mm लेंस, नरम धुंध, फ़िल्म ग्रेन
• सुबह की खिड़की की रोशनी में एक सिरेमिक स्टूडियो शेल्फ़, 85mm लेंस, उथली डेप्थ ऑफ़ फ़ील्ड
• शाम के समय एक पत्थर के पुल को पार करता साइकिल सवार, एरियल व्यू, गर्म रोशनी, हल्का मोशन ब्लर

हर मॉडल, इमेज और वीडियो जेनरेटर से लेकर लैंग्वेज मॉडल तक, picassoia.com/en/all-models पर ब्राउज़ करें, और आज ही PicassoIA पर अपनी इमेज बनाना शुरू करें।