SUNRA MCP सर्वर सेट अप करना

SUNRA मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर लोकप्रिय विकास परिवेशों के साथ निर्बाध एकीकरण प्रदान करता है, जिससे आप अपने संपादक या IDE से सीधे SUNRA के AI मॉडल तक पहुंच सकते हैं। यह मार्गदर्शिका आपको विभिन्न उपकरणों के साथ MCP सर्वर सेट अप करने के बारे में बताएगी।

MCP क्या है?

मॉडल संदर्भ प्रोटोकॉल (MCP) AI सहायकों के लिए बाहरी संसाधनों और उपकरणों तक सुरक्षित रूप से पहुंचने का एक मानकीकृत तरीका है। SUNRA MCP सर्वर आपको इसकी अनुमति देता है:
  • SUNRA पर उपलब्ध AI मॉडल की सूची बनाना और खोजना
  • किसी भी मॉडल एंडपॉइंट पर अनुरोध सबमिट करना
  • कतार प्रणाली से स्थिति जांचना और परिणाम प्राप्त करना
  • फ़ाइलें अपलोड करना और मॉडल स्कीमा प्रबंधित करना
  • API प्रमाणीकरण को निर्बाध रूप से प्रबंधित करना

पूर्वापेक्षाएँ

MCP सर्वर सेट अप करने से पहले, सुनिश्चित करें कि आपके पास है:
  1. Node.js स्थापित (संस्करण 18 या उच्चतर)
  2. आपके डैशबोर्ड से SUNRA API कुंजी
  3. आपका पसंदीदा संपादक/IDE स्थापित

स्थापना

SUNRA MCP सर्वर एक npm पैकेज के रूप में उपलब्ध है:
npm install -g @sunra/mcp-server
या इसे सीधे npx के साथ उपयोग करें (अनुशंसित):
npx @sunra/mcp-server

संपादक द्वारा विन्यास

कर्सर

कर्सर अपनी कॉन्फ़िगरेशन फ़ाइल के माध्यम से MCP का समर्थन करता है। अपने प्रोजेक्ट रूट में .cursor/mcp.json बनाएं या अपडेट करें:
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}
आपकी उपयोगकर्ता सेटिंग्स में वैकल्पिक वैश्विक कॉन्फ़िgeration:
  1. कर्सर सेटिंग्स खोलें
  2. “MCP सर्वर” पर नेविगेट करें
  3. इसके साथ एक नया सर्वर जोड़ें:
    • नाम: sunra-mcp-server
    • आदेश: npx
    • तर्क: @sunra/mcp-server

वीएस कोड

MCP समर्थन के साथ वीएस कोड के लिए (संगत एक्सटेंशन की आवश्यकता है): .vscode/mcp.json बनाएं:
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}

क्लाइन

क्लाइन अपनी सेटिंग्स के माध्यम से MCP सर्वर का समर्थन करता है। अपनी क्लाइन कॉन्फ़िगरेशन में जोड़ें:
{
  "mcpServers": {
    "sunra": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "description": "SUNRA AI मॉडल एक्सेस"
    }
  }
}

विंडसर्फ

विंडसर्फ आईडीई के लिए, कार्यक्षेत्र सेटिंग्स में MCP को कॉन्फ़िगर करें:
{
  "mcp": {
    "servers": {
      "sunra-mcp-server": {
        "command": "npx",
        "args": ["@sunra/mcp-server"],
        "timeout": 30000
      }
    }
  }
}

क्लाउड डेस्कटॉप

अपनी क्लाउड डेस्कटॉप कॉन्फ़िगरेशन फ़ाइल में जोड़ें: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"]
    }
  }
}

अन्य MCP-संगत उपकरण

MCP का समर्थन करने वाले किसी भी अन्य उपकरण के लिए, इस सामान्य कॉन्फ़िगरेशन पैटर्न का उपयोग करें:
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "${SUNRA_KEY}"
      }
    }
  }
}

पर्यावरण सेटअप

अपनी एपीआई कुंजी सेट करना

आप अपनी SUNRA API कुंजी को कई तरीकों से कॉन्फ़िगर कर सकते हैं:

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

export SUNRA_KEY="your-api-key-here"
विंडोज के लिए:
set SUNRA_KEY=your-api-key-here

विकल्प 2: कॉन्फ़िगरेशन फ़ाइल

कुछ संपादक आपको MCP कॉन्फ़िगरेशन में सीधे पर्यावरण चर सेट करने की अनुमति देते हैं:
{
  "mcpServers": {
    "sunra-mcp-server": {
      "command": "npx",
      "args": ["@sunra/mcp-server"],
      "env": {
        "SUNRA_KEY": "your-api-key-here"
      }
    }
  }
}

विकल्प 3: रनटाइम कॉन्फ़िगरेशन

MCP सर्वर set-sunra-key टूल का उपयोग करके रनटाइम पर API कुंजी सेट करने का भी समर्थन करता है।

उपलब्ध एमसीपी उपकरण

एक बार कॉन्फ़िगर हो जाने पर, आप अपने AI सहायक के माध्यम से इन उपकरणों तक पहुंच प्राप्त करेंगे:

मॉडल प्रबंधन

  • list-models - सभी उपलब्ध AI मॉडल ब्राउज़ करें
  • search-models - कीवर्ड द्वारा मॉडल खोजें
  • model-schema - विशिष्ट मॉडलों के लिए इनपुट/आउटपुट स्कीमा प्राप्त करें

अनुरोध प्रबंधन

  • submit - मॉडल एंडपॉइंट पर अनुरोध सबमिट करें
  • status - अनुरोध की स्थिति और लॉग जांचें
  • result - पूर्ण परिणाम प्राप्त करें
  • cancel - चल रहे अनुरोधों को रद्द करें
  • subscribe - सबमिट करें और पूरा होने की प्रतीक्षा करें

फ़ाइल प्रबंधन

  • upload - SUNRA स्टोरेज पर फ़ाइलें अपलोड करें

उपयोग के उदाहरण

उपलब्ध मॉडल सूचीबद्ध करना

उपलब्ध AI मॉडल दिखाने के लिए list-models टूल का उपयोग करें।

एक छवि बनाना

black-forest-labs/flux-1.1-pro/text-to-image एंडपॉइंट के साथ एक छवि बनाने के लिए सबमिट टूल का उपयोग करें।
प्रॉम्प्ट का उपयोग करें: "सूर्यास्त के समय एक शांत पहाड़ी परिदृश्य"

अनुरोध की स्थिति की जाँच करना

अनुरोध आईडी की स्थिति जांचें: pd_xxxxxx

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

सामान्य मुद्दे

एमसीपी सर्वर नहीं मिला
  • सुनिश्चित करें कि Node.js स्थापित और सुलभ है
  • विश्व स्तर पर स्थापित करने का प्रयास करें: npm install -g @sunra/mcp-server
  • सत्यापित करें कि कमांड पथ सही है
प्रमाणीकरण त्रुटियां
  • जांचें कि आपका SUNRA_KEY पर्यावरण चर सेट है
  • SUNRA डैशबोर्ड पर अपनी API कुंजी की वैधता सत्यापित करें
  • set-sunra-key टूल का उपयोग करके कुंजी सेट करने का प्रयास करें
कनेक्शन टाइमआउट
  • अपनी कॉन्फ़िगरेशन में टाइमआउट मान बढ़ाएँ
  • अपने इंटरनेट कनेक्शन की जाँच करें
  • SUNRA API स्थिति सत्यापित करें
अनुमति त्रुटियां
  • कॉन्फ़िगरेशन फ़ाइलों के लिए उचित फ़ाइल अनुमतियाँ सुनिश्चित करें
  • उपयुक्त उपयोगकर्ता अनुमतियों के साथ चलाने का प्रयास करें

मदद प्राप्त करना

यदि आपको समस्याएँ आती हैं:
  1. SUNRA दस्तावेज़ीकरण देखें
  2. अपने संपादक के MCP दस्तावेज़ीकरण की समीक्षा करें
  3. गिटहब पर एक मुद्दा उठाएं

अगले कदम

एक बार जब आपका MCP सर्वर कॉन्फ़िगर हो जाए:
  1. मॉडल एक्सप्लोर करें: सभी उपलब्ध AI क्षमताओं को देखने के लिए list-models का उपयोग करें
  2. उदाहरण आज़माएं: सरल टेक्स्ट-टू-इमेज या टेक्स्ट-टू-वीडियो पीढ़ी के साथ शुरू करें
  3. वर्कफ़्लो बनाएं: जटिल AI पाइपलाइनों के लिए कई मॉडलों को मिलाएं
  4. उपयोग की निगरानी करें: SUNRA डैशबोर्ड में अपने API उपयोग को ट्रैक करें
MCP एकीकरण आपके विकास वर्कफ़्लो में शक्तिशाली AI मॉडल को सीधे शामिल करना आसान बनाता है, जिससे आपके अनुप्रयोगों में तेजी से प्रोटोटाइप और निर्बाध AI-संचालित सुविधाएँ सक्षम होती हैं।