Docker में solvethree MCP सर्वर चलाएँ

इसे Dockerfile के रूप में सहेजें। यह Node 22 पर आधिकारिक पैकेज इंस्टॉल करता है, गैर-रूट node उपयोगकर्ता पर स्विच करता है और कंटेनर के एंट्रीपॉइंट के रूप में solvethree-mcp शुरू करता है। बिल्ड और रन कमांड नीचे दिए गए हैं।

FROM node:22.23.4-alpine
RUN npm install --global https://solvethree.com/downloads/solvethree-sdk-0.1.0.tgz
USER node
ENTRYPOINT ["solvethree-mcp"]

# Build: docker build -t solvethree-mcp-local .
# Forward variables already set in the host; do not add their values to this file.
# Run: docker run --rm -i -e SOLVETHREE_API_KEY -e SOLVETHREE_PROXY solvethree-mcp-local

इसे चलाने से पहले, Docker लॉन्च करने वाले एनवायरनमेंट में SOLVETHREE_API_KEY को अपनी वर्कस्पेस API कुंजी पर और SOLVETHREE_PROXY को अपनी प्रॉक्सी पर सेट करें। हर -e NAME मौजूदा वेरिएबल को आगे भेजता है; यह कोई मान नहीं देता। क्रेडेंशियल को Dockerfile और इमेज में शामिल न करें।

इमेज स्थानीय रूप से solvethree-mcp-local नाम से बनती है; Docker Hub खाते की ज़रूरत नहीं है। इसे चलाने से कोई होस्टेड MCP एंडपॉइंट नहीं बनता और न ही ब्राउज़र ऑटोमेशन जुड़ता है।

अपने MCP होस्ट में stdio सर्वर कॉन्फ़िगर करें। कमांड के रूप में Docker का उपयोग करें, solvethree-mcp का नहीं: इमेज का एंट्रीपॉइंट कंटेनर के अंदर एक्ज़ीक्यूटेबल शुरू करता है।

-t न जोड़ें। होस्ट को JSON-RPC के लिए कंटेनर के stdin और stdout की ज़रूरत होती है। कंटेनर के बंद होने पर --rm उसे हटा देता है।

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

Codex-शैली के TOML कॉन्फ़िगरेशन के लिए, ऊपर दी गई कमांड और आर्ग्युमेंट के साथ mcp_servers.solvethree टेबल का उपयोग करें। env_vars में दोनों वेरिएबल के नाम शामिल करें, startup_timeout_sec को 60 और tool_timeout_sec को 100 पर सेट करें। अंतर्निहित सर्वर अनुबंध के लिए MCP इंटीग्रेशन दस्तावेज़ देखें।

1. 1.

   उपलब्ध टूल जाँचें

   कनेक्ट करने के बाद solvethree_capabilities कॉल करें। सर्वर समाधान और टास्क प्राप्त करने के टूल उपलब्ध कराता है; यह ब्राउज़र नहीं चलाता और फ़ॉर्म नहीं भरता।

2. 2.

   reCAPTCHA प्रोफ़ाइल तैयार करें

   reCAPTCHA के लिए, समाधान का अनुरोध करने से पहले साइट प्रोफ़ाइल में सक्रिय प्रोफ़ाइल सेट अप करें। होस्टनाम, कैप्चर ऐक्शन और reCAPTCHA प्रकार का मिलान करें; यह न मानें कि एक डोमेन प्रोफ़ाइल हर ऐक्शन को कवर करती है। टास्क भेजने से प्रोफ़ाइल नहीं बनती। प्रोफ़ाइल सेटअप गाइड में यह पूर्वापेक्षा समझाई गई है।

3. 3.

   एक तार्किक टास्क बनाएँ

   site, action और एक requestId के साथ solvethree_create_recaptcha कॉल करें; recaptchaType और waitMs वैकल्पिक हैं। यह टूल अपनी एकमात्र प्रॉक्सी SOLVETHREE_PROXY से पढ़ता है। हर create कॉल अधिकतम एक टास्क बनाती है। अगर टास्क बनाते समय टाइम आउट हो जाए, तो नया टास्क बनाने के बजाय मौजूदा टास्क को पुनः प्राप्त करने के लिए बिना इनपुट बदले उसी अनुरोध ID का उपयोग करें।

4. 4.

   उपयोग योग्य परिणाम की प्रतीक्षा करें

   अगर टास्क की स्थिति pending या solving है, तो उसे solvethree_get_task से प्राप्त करें। केवल ready में उपयोग योग्य समाधान होता है। failed होने पर पोलिंग रोक दें और क्या बदलना है, यह तय करने से पहले errorCode और error की जाँच करें।

5. 5.

   अपने एप्लिकेशन से सबमिट करें

   reCAPTCHA के लिए solution.token सबमिट करें, टास्क ID नहीं। लौटाई गई userAgent और secChUa पहचान का उपयोग सफल प्रॉक्सी के साथ करें। तैयार टास्क का अर्थ है कि समाधान जनरेट हो गया है, यह नहीं कि लक्ष्य ने आपका एप्लिकेशन अनुरोध स्वीकार कर लिया है।

MCP होस्ट को निजी समाधान डेटा मिलता है। इन परिणामों को साझा लॉग में शामिल न करें; इन्हें इच्छित लक्ष्य को सबमिट करने की ज़िम्मेदारी आपके एप्लिकेशन की ही रहती है।