एमसीपी सेवा

मॉडल कॉन्टेक्स्ट प्रोटोकॉल के माध्यम से एआई एजेंटों के सामने कैपसॉल्वर की समाधान क्षमता को उजागर करें। कोई भी एमसीपी क्लाइंट जो इस सेवा की ओर इशारा करता है उसे पांच समाधान उपकरण मिलते हैं - बिना किसी ग्लू कोड के।

1. अवलोकन

मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) एक खुला प्रोटोकॉल है जो एआई क्लाइंट को बाहरी टूल खोजने और कॉल करने की सुविधा देता है। आप एक क्षमता को एमसीपी सेवा के रूप में पैकेज करते हैं, और कोई भी संगत क्लाइंट कनेक्ट होने पर सीधे इसके टूल का उपयोग कर सकता है - प्रति-क्लाइंट एडाप्टर कोड लिखे बिना।

capsolver-mcp बिल्कुल ऐसी ही सेवा है: यह capsolver-core की समाधान क्षमता को मानक MCP टूल के रूप में लपेटती है। एक बार शुरू होने पर, एमसीपी-सक्षम क्लाइंट (क्लाउड डेस्कटॉप, क्लाउड कोड, कर्सर, क्लाइन और अन्य) स्वचालित रूप से टूल की खोज करते हैं और कैप्चा को साफ़ करने, पता लगाने, हल करने और वापस भरने के लिए उन्हें सीधे बातचीत में कॉल कर सकते हैं।

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

2. स्थापना

capsolver-mcp को capsolver-core के शीर्ष पर बनाया गया है - कोर वास्तविक समाधान करता है, और mcp केवल MCP प्रोटोकॉल पर अपनी क्षमता को उजागर करता है - इसलिए यह रनटाइम पर capsolver-core पर निर्भर करता है। आप अकेले mcp स्थापित नहीं कर सकते: पहले GitHub से कोर स्थापित करें, फिर mcp:

# 1) Install the core engine first (mcp depends on it)
pip install git+https://github.com/capsolver-ai/capsolver-core.git
 
# 2) Then install mcp itself
pip install git+https://github.com/capsolver-ai/capsolver-mcp.git

ब्राउज़र टूल (detect / solve_on_page) को भी Playwright की आवश्यकता है - चरण 2 को [browser] अतिरिक्त से बदलें और क्रोमियम इंस्टॉल करें:

pip install "capsolver-mcp[browser] @ git+https://github.com/capsolver-ai/capsolver-mcp.git"
playwright install chromium

3. उपकरण

एक बार शुरू होने पर, सेवा ग्राहक को निम्नलिखित पांच टूल का विज्ञापन करती है:

उपकरण	ब्राउज़र?	विवरण
`solve_captcha`	नहीं	प्रकार + साइट पैरामीटर (टोकन मोड) द्वारा हल करें
`detect_captchas`	हाँ	एक पेज यूआरएल को स्कैन करें और मौजूद कैप्चा प्रकारों को सूचीबद्ध करें
`solve_on_page`	हाँ	पृष्ठ पर प्रत्येक कैप्चा का पता लगाएं + हल करें + वापस भरें
`get_balance`	नहीं	अकाउंट बैलेंस और पैकेज के बारे में पूछताछ करें
`get_supported_captchas`	नहीं	सभी समर्थित कैप्चा प्रकार और हैंडलर की सूची बनाएं

ब्राउज़र टूल (detect_captchas, solve_on_page) को [browser] अतिरिक्त और क्रोमियम की आवश्यकता होती है - बस ऊपर दिए गए ब्राउज़र निर्देशों के साथ इंस्टॉल करें।

4. सेवा प्रारंभ करना

4.1 कमांड लाइन

# stdio (default — for local MCP clients such as Claude Desktop)
capsolver-mcp
 
# SSE (for remote / HTTP access)
capsolver-mcp --transport sse --host 0.0.0.0 --port 8000
 
# Streamable HTTP (MCP 2025-03-26 spec)
capsolver-mcp --transport streamable-http --host 0.0.0.0 --port 8000

कमांड-लाइन विकल्प:

capsolver-mcp [OPTIONS]
  --transport {stdio,sse,streamable-http}   Transport protocol (default: stdio)
  --host HOST                 Bind host for SSE/HTTP transport (default: 127.0.0.1)
  --port PORT                 Bind port for SSE/HTTP transport (default: 8000)
  --api-key KEY               API key (falls back to the CAPSOLVER_API_KEY env var)
  --name NAME                 Service name (default: capsolver)

4.2 एमसीपी कॉन्फ़िगरेशन

एक MCP क्लाइंट इस सेवा को JSON कॉन्फ़िगरेशन के एक ब्लॉक के माध्यम से लोड करता है। सबसे आम है stdio दृष्टिकोण: क्लाइंट आपके द्वारा प्रदान किए गए आदेश का उपयोग करके सेवा को चाइल्ड प्रोसेस के रूप में लॉन्च करता है। command को बंडल किए गए capsolver-mcp पर सीधे सेट करें:

{
  "mcpServers": {
    "capsolver": {
      "command": "capsolver-mcp",
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

यदि ग्राहक रिपोर्ट करता है कि उसे capsolver-mcp नहीं मिल रहा है (सामान्य जब यह एक कोंडा / वेन वातावरण में स्थापित होता है जो ग्राहक के PATH पर नहीं है), तो उस वातावरण के पायथन पर command को इंगित करें और मॉड्यूल के माध्यम से लॉन्च करें:

{
  "mcpServers": {
    "capsolver": {
      "command": "/abs/path/to/venv/bin/python",
      "args": ["-m", "capsolver_mcp"],
      "env": {
        "CAPSOLVER_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

5. क्लाइंट सेटअप और टूल डेमो

अधिकांश एमसीपी क्लाइंट §4.2 से कॉन्फिग ब्लॉक से जुड़ते हैं। नीचे वीएस कोड के लिए विशिष्ट चरण, कुछ टूल डेमो और अन्य ग्राहकों के लिए अंतर दिए गए हैं।

5.1 वीएस कोड (क्लाउड प्लगइन)

एक नया mcp.json बनाएं।
mcpServers के अंतर्गत संबंधित कॉन्फ़िगरेशन जोड़ें।
वीएस कोड पुनः लोड करें। पुनः लोड करने के बाद, CapSolver के पांच उपकरण टूल सूची में दिखाई देते हैं।

5.2 टूल डेमो

क्लाइंट से किसी टूल को कॉल करवाने के लिए बस प्राकृतिक भाषा का उपयोग करें। यहां तीन विशिष्ट उपयोग और उनके अपेक्षित परिणाम दिए गए हैं:

शेष राशि जांचें - “मेरे खाते की शेष राशि जांचने के लिए कैप्सॉल्वर का उपयोग करें।” ग्राहक get_balance पर कॉल करता है और शेष राशि और पैकेज लौटाता है।

टोकन-मोड समाधान - प्रकार, यूआरएल और साइट कुंजी दें: “मेरे लिए इस रीकैप्चा v2 को हल करें।” ग्राहक solve_captcha पर कॉल करता है और एक टोकन लौटाता है।

पूरा पृष्ठ, एक शॉट - “इस पृष्ठ पर प्रत्येक कैप्चा का पता लगाएं और हल करें: <URL>।” क्लाइंट पता लगाने + हल करने + वापस भरने के लिए solve_on_page को कॉल करता है।

5.3 अन्य ग्राहक

वही command + env कॉन्फ़िगरेशन अन्य stdio MCP क्लाइंट पर लागू होता है। उदाहरण के तौर पर यहां कर्सर है:

ध्यान दें: कर्सर को capsolver-mcp से कनेक्ट करने के लिए शर्त यह है कि दोनों पैकेज स्थापित हों:
#1) पहले कोर इंजन स्थापित करें (एमसीपी इस पर निर्भर करता है)
पिप इंस्टॉल गिट+ https://github.com/capsolver-ai/capsolver-core.git
#2) फिर mcp को ही इनस्टॉल करें
पिप इंस्टॉल गिट+ https://github.com/capsolver-ai/capsolver-mcp.git

एजेंट उपकरण क्यों कैपसॉल्वर चुनें?