suprsonic-mcp

@suprsonic/mcp

Suprsonic के लिए MCP सर्वर। किसी भी AI एजेंट को एक ही कनेक्शन के माध्यम से दर्जनों क्षमताएँ प्रदान करता है।

त्वरित शुरुआत

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp

अपनी API कुंजी suprsonic.ai/app/apis पर प्राप्त करें।

Claude डेस्कटॉप

~/Library/Application Support/Claude/claude_desktop_config.json में जोड़ें:

{
  "mcpServers": {
    "suprsonic": {
      "command": "npx",
      "args": ["-y", "@suprsonic/mcp"],
      "env": {
        "SUPRSONIC_API_KEY": "omk_your_key"
      }
    }
  }
}

Cursor / VS Code

.cursor/mcp.json या VS Code MCP कॉन्फ़िग में जोड़ें:

{
  "suprsonic": {
    "command": "npx",
    "args": ["-y", "@suprsonic/mcp"],
    "env": {
      "SUPRSONIC_API_KEY": "omk_your_key"
    }
  }
}

दूरस्थ HTTP (Claude API, ChatGPT, प्रोग्रामेटिक एजेंट के लिए)

SUPRSONIC_API_KEY=omk_your_key npx -y @suprsonic/mcp --http --port 3100

फिर http://localhost:3100/mcp से कनेक्ट करें।

उपलब्ध उपकरण

उपकरण	यह क्या करता है
search	वेब खोजें (AI संश्लेषण, SERP, या दोनों)
scrape	किसी भी URL से सामग्री को Markdown के रूप में निकालें
profiles	नाम या LinkedIn URL द्वारा पेशेवर प्रोफ़ाइल खोजें
emails	पेशेवर ईमेल पते खोजें
images	टेक्स्ट प्रॉम्प्ट से चित्र बनाएँ
tts	टेक्स्ट को वाक् में बदलें
stt	ऑडियो को टेक्स्ट में ट्रांसक्राइब करें
sms	SMS या WhatsApp संदेश भेजें
documents	URL से संरचित डेटा निकालें
companies	डोमेन द्वारा कंपनी डेटा देखें
email-verify	जाँचें कि ईमेल वितरण योग्य है या नहीं
transcribe	वक्ता लेबल के साथ ऑडियो ट्रांसक्राइब करें
invoice-parse	चालान से डेटा निकालें
subtitle	SRT/VTT उपशीर्षक बनाएँ
file-convert	200+ प्रारूपों के बीच फ़ाइलें बदलें
bg-remove	चित्र की पृष्ठभूमि हटाएँ
screenshot	वेबपेज स्क्रीनशॉट कैप्चर करें

प्रतिक्रिया प्रारूप

प्रत्येक उपकरण एक एकीकृत प्रतिक्रिया ऑब्जेक्ट लौटाता है:

{
  "success": true,
  "data": {
    "results": [
      { "title": "OpenAI raises $6.6B", "url": "https://...", "snippet": "..." }
    ]
  },
  "error": null,
  "metadata": {
    "provider_used": "serperdev",
    "providers_tried": ["serperdev"],
    "response_time_ms": 1200,
    "request_id": "req_abc123"
  },
  "credits_used": 1
}

विफलता पर, success false होता है और error में विवरण होता है (नीचे देखें)।

त्रुटि प्रबंधन

त्रुटि ऑब्जेक्ट संरचना (जब success false हो तब लौटाई जाती है):

{
  "type": "billing_error",
  "title": "Insufficient credits",
  "status": 402,
  "detail": "Your account has 0 credits remaining. Add credits at suprsonic.ai/app/billing.",
  "is_retriable": false,
  "retry_after_seconds": null,
  "error_category": "billing"
}

त्रुटि श्रेणियाँ: transient (पुनः प्रयास सुरक्षित), permanent (खराब अनुरोध), authentication (अमान्य कुंजी), billing (क्रेडिट समाप्त)।

MCP का उपयोग करते समय, AI एजेंट उपकरण प्रतिक्रिया में त्रुटि प्राप्त करता है और is_retriable और retry_after_seconds के आधार पर पुनः प्रयास करने का निर्णय ले सकता है।

सभी पैरामीटर और उदाहरण प्रतिक्रियाओं के साथ पूर्ण API संदर्भ: suprsonic.ai/apis