MiniMax MCP

आधिकारिक MiniMax मॉडल संदर्भ प्रोटोकॉल (MCP) सर्वर जो शक्तिशाली टेक्स्ट टू स्पीच और वीडियो/इमेज जनरेशन API के साथ इंटरैक्शन सक्षम करता है। यह सर्वर Claude Desktop, Cursor, Windsurf, OpenAI Agents और अन्य जैसे MCP क्लाइंट्स को स्पीच जनरेट करने, आवाज़ क्लोन करने, वीडियो जनरेट करने, इमेज जनरेट करने और अधिक की अनुमति देता है।

💡 अनुशंसित: MiniMax CLI (mmx-cli) — हमारा आधिकारिक कमांड-लाइन टूल जिसमें नवीनतम मॉडल और टेक्स्ट, विज़न, सर्च और म्यूज़िक कवर सहित अतिरिक्त सुविधाएँ हैं। Claude Code, Cursor, OpenClaw आदि के लिए AI एजेंट स्किल के रूप में काम करता है।

दस्तावेज़ीकरण

• 中文文档
• MiniMax-MCP-JS - MiniMax MCP का आधिकारिक जावास्क्रिप्ट कार्यान्वयन

MCP क्लाइंट के साथ त्वरित शुरुआत

1. अपनी API कुंजी MiniMax से प्राप्त करें।
2. uv (पायथन पैकेज मैनेजर) इंस्टॉल करें, curl -LsSf https://astral.sh/uv/install.sh | sh के साथ इंस्टॉल करें या अतिरिक्त इंस्टॉल विधियों के लिए uv रेपो देखें।
3. महत्वपूर्ण: API होस्ट और कुंजी क्षेत्र के अनुसार भिन्न होते हैं और मेल खाने चाहिए; अन्यथा, आपको Invalid API key त्रुटि का सामना करना पड़ेगा।

क्षेत्र	वैश्विक	मुख्यभूमि
MINIMAX_API_KEY	MiniMax Global से प्राप्त करें	MiniMax से प्राप्त करें
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

निम्नलिखित शामिल करने के लिए Claude > Settings > Developer > Edit Config > claude_desktop_config.json पर जाएं:

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert-your-api-key-here",
        "MINIMAX_MCP_BASE_PATH": "local-output-dir-path, such as /User/xxx/Desktop",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format"
      }
    }
  }
}

⚠️ चेतावनी: API कुंजी को होस्ट से मेल खाना चाहिए। यदि "API Error: invalid api key" त्रुटि होती है, तो कृपया अपना API होस्ट जांचें:

• वैश्विक होस्ट：https://api.minimax.io
• मुख्यभूमि होस्ट：https://api.minimaxi.com

यदि आप विंडोज का उपयोग कर रहे हैं, तो MCP सर्वर का उपयोग करने के लिए आपको Claude Desktop में "डेवलपर मोड" सक्षम करना होगा। ऊपर बाईं ओर हैमबर्गर मेनू में "सहायता" पर क्लिक करें और "डेवलपर मोड सक्षम करें" चुनें।

Cursor

उपरोक्त कॉन्फ़िग जोड़ने के लिए Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server पर जाएं।

बस इतना ही। आपका MCP क्लाइंट अब इन टूल्स के माध्यम से MiniMax के साथ इंटरैक्ट कर सकता है:

ट्रांसपोर्ट

हम दो ट्रांसपोर्ट प्रकारों का समर्थन करते हैं: stdio और sse।

stdio	SSE
स्थानीय रूप से चलाएं	स्थानीय रूप से या क्लाउड में तैनात किया जा सकता है
stdout के माध्यम से संचार	network के माध्यम से संचार
इनपुट: local files या मान्य URL संसाधनों को संसाधित करने का समर्थन करता है	इनपुट: क्लाउड में तैनात होने पर, इनपुट के लिए URL का उपयोग करने की अनुशंसा की जाती है

उपलब्ध टूल

टूल	विवरण
text_to_audio	दी गई आवाज़ के साथ टेक्स्ट को ऑडियो में बदलें
list_voices	सभी उपलब्ध आवाज़ों की सूची बनाएं
voice_clone	प्रदान की गई ऑडियो फ़ाइलों का उपयोग करके आवाज़ क्लोन करें
generate_video	प्रॉम्प्ट से वीडियो जनरेट करें
text_to_image	प्रॉम्प्ट से इमेज जनरेट करें
query_video_generation	वीडियो जनरेशन कार्य का परिणाम क्वेरी करें
music_generation	प्रॉम्प्ट और लिरिक्स से म्यूज़िक ट्रैक जनरेट करें
voice_design	प्रीव्यू टेक्स्ट का उपयोग करके प्रॉम्प्ट से आवाज़ जनरेट करें

रिलीज़ नोट्स

2 जुलाई, 2025

🆕 नया क्या है

• वॉइस डिज़ाइन: नया voice_design टूल - प्रीव्यू ऑडियो के साथ वर्णनात्मक प्रॉम्प्ट से कस्टम आवाज़ें बनाएं
• वीडियो एन्हांसमेंट: अल्ट्रा-क्लियर क्वालिटी और अवधि/रिज़ॉल्यूशन नियंत्रण के साथ MiniMax-Hailuo-02 मॉडल जोड़ा गया
• म्यूज़िक जनरेशन: music-1.5 मॉडल द्वारा संचालित music_generation टूल को बढ़ाया गया

📈 उन्नत टूल

• voice_design - टेक्स्ट विवरण से व्यक्तिगत आवाज़ें जनरेट करें
• generate_video - अब 6s/10s अवधि और 768P/1080P रिज़ॉल्यूशन विकल्पों के साथ MiniMax-Hailuo-02 का समर्थन करता है
• music_generation - music-1.5 मॉडल के साथ उच्च-गुणवत्ता वाला संगीत निर्माण

सामान्य प्रश्न

1. अमान्य API कुंजी

कृपया सुनिश्चित करें कि आपकी API कुंजी और API होस्ट क्षेत्रीय रूप से संरेखित हैं

क्षेत्र	वैश्विक	मुख्यभूमि
MINIMAX_API_KEY	MiniMax Global से प्राप्त करें	MiniMax से प्राप्त करें
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

कृपया अपने टर्मिनल में यह कमांड चलाकर इसके पूर्ण पथ की पुष्टि करें:

which uvx

एक बार जब आप पूर्ण पथ प्राप्त कर लें (जैसे, /usr/local/bin/uvx), तो उस पथ का उपयोग करने के लिए अपना कॉन्फ़िगरेशन अपडेट करें (जैसे, "command": "/usr/local/bin/uvx")।

3. एसिंक-मोड में generate_video का उपयोग कैसे करें

शुरू करने से पहले पूर्णता नियम परिभाषित करें: वैकल्पिक रूप से, इन नियमों को आपकी IDE सेटिंग्स में कॉन्फ़िगर किया जा सकता है (जैसे, Cursor):

उदाहरण उपयोग

⚠️ चेतावनी: इन टूल्स का उपयोग करने पर लागत लग सकती है।

1. शाम के समाचार का एक खंड प्रसारित करें

2. एक आवाज़ क्लोन करें

3. एक वीडियो जनरेट करें

4. इमेज जनरेट करें