/ الدليل / الملعب / MiniMax-MCP
← كل الخوادم ↗ GitHub
● مجتمع MiniMax-AI ⚡ فوري

MiniMax-MCP

بواسطة MiniMax-AI · MiniMax-AI/MiniMax-MCP

مكون MCP رسمي من MiniMax — تحويل النصوص إلى كلام، واستنساخ الأصوات، وتحويل النصوص إلى صور، وتحويل النصوص إلى فيديو، وتوليد الموسيقى، كل ذلك من خلال الدردشة.

MiniMax-AI/MiniMax-MCP هو مكون MCP رسمي من MiniMax يغلف واجهات برمجة التطبيقات الخاصة بهم لتحويل النص إلى كلام، وتصميم الأصوات، والصور، والفيديو، والموسيقى. مختص حسب المنطقة الجغرافية: للعالمية (api.minimax.io) والبر الرئيسي (api.minimaxi.com) مفاتيح منفصلة.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

minimax.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "minimax",
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "minimax": {
      "command": {
        "path": "uvx",
        "args": [
          "MiniMax-MCP"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add minimax -- uvx MiniMax-MCP

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: MiniMax-MCP

كيفية تحويل مقالة المدونة إلى صوت السرد

👤 منشئو المحتوى، مقدمو البرامج الصوتية، فرق الإمكانية ⏱ ~15 min beginner

متى تستخدمه: عندما تريد نسخة قابلة للاستماع من المحتوى المكتوب.

المتطلبات الأساسية
  • حساب MiniMax + مفتاح API — للعالمية: minimax.io؛ والبر الرئيسي: minimaxi.com. اضبط MINIMAX_API_KEY + MINIMAX_API_HOST لمطابقة المنطقة
  • تثبيت uvx — brew install uv
الخطوات
  1. قائمة الأصوات
    list_voices — عرض جميع الأصوات المتاحة باللغة الإنجليزية.✓ تم النسخ
    → كتالوج الأصوات مع المعاينات
  2. عرض الصوت
    text_to_audio: [الصق المقالة] مع الصوت 'female-calm-en'. احفظ إلى /audio/article.mp3.✓ تم النسخ
    → تم حفظ ملف MP3، تم إرجاع عنوان URL

النتيجة: نسخة صوتية قابلة للاستماع من محتواك.

المزالق
  • المقالات الطويلة تصل إلى حدود الأحرف لكل استدعاء — قسمها إلى فقرات، واعرضها، وادمجها
  • نطق الأسماء الخاصة غير صحيح — استخدم تلميحات صوتية على نمط SSML أو أداة voice_design للأصوات المتخصصة
اجمعها مع: filesystem

كيفية استنساخ صوتك الخاص للسرد

👤 منشئو المحتوى الذين يريدون راويًا متسقًا ⏱ ~10 min intermediate

متى تستخدمه: عندما تريد سردًا بالذكاء الاصطناعي بصوتك الخاص.

المتطلبات الأساسية
  • عينة صوتية بطول 10-60 ثانية (صوت نظيف، صوتك) — سجل عبر هاتفك؛ صدره بصيغة mp3/wav
الخطوات
  1. استنساخ
    voice_clone مع العينة /recordings/me.wav، والاسم 'my-voice'.✓ تم النسخ
    → تم إرجاع معرّف الصوت
  2. استخدمه
    text_to_audio مع voice='my-voice' على [الصق النص].✓ تم النسخ
    → الإخراج بصوتك

النتيجة: سرد شخصي بدون ميكروفون في كل مرة.

المزالق
  • استخدام صوت شخص آخر بدون موافقة — لا تفعل — مشكلة قانونية وأخلاقية؛ استخدم voice_design بدلاً من ذلك

كيفية توليد صورة وتحويلها إلى فيديو قصير

👤 منشئو المحتوى، المسوقون ⏱ ~15 min intermediate

متى تستخدمه: محتوى وسائل التواصل الاجتماعي، معاينات المنتجات.

الخطوات
  1. توليد الصورة
    text_to_image: 'لقطة منتج استوديو بسيطة لفنجان خزفي، إضاءة طبيعية'.✓ تم النسخ
    → عنوان URL للصورة
  2. الرسوم المتحركة
    generate_video مع الإشارة 'فنجان يدور ببطء على طاولة خشبية'. استقصِ الحالة مع query_video_generation.✓ تم النسخ
    → عنوان URL للفيديو عند الانتهاء

النتيجة: مقطع تسويقي قصير.

المزالق
  • توليد الفيديو غير متزامن ويمكن أن يستغرق دقائق — استخدم دائمًا query_video_generation للاستقصاء — لا تحجب الدردشة في انتظار
اجمعها مع: google-workspace

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

minimax + filesystem

حفظ الموارد المولدة في مجلد محتوى منظم

توليد السرد لكل فصل في /manuscript/ وحفظ ملفات MP3 في /audio/chapters/.✓ تم النسخ
minimax + google-workspace

إنتاج صوت من مستند Google، ثم إرفاقه كرابط في المستند

اقرأ المستند 'Launch Post'، وولد السرد، وحمل إلى Drive، وأضف الرابط كتذييل.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
text_to_audio text: str, voice: str, format?: 'mp3'|'wav', output_path? سرد النص Per MiniMax TTS pricing
list_voices language?: str العثور على صوت free
voice_clone sample_path: str, name: str صوت مخصص Per MiniMax pricing
voice_design description: str توليد صوت من النص Per MiniMax pricing
text_to_image prompt: str, aspect_ratio? توليد الصور Per MiniMax image pricing
generate_video prompt: str, duration_s? بدء توليد الفيديو Per MiniMax video pricing
query_video_generation task_id استقصاء مهمة الفيديو free
music_generation lyrics: str, genre?: str إنشاء مقطع موسيقي قصير Per MiniMax music pricing

التكلفة والحدود

تكلفة التشغيل

حصة API
وفقًا لخطة MiniMax — تحقق من التسعير الحالي على minimax.io أو minimaxi.com
الرموز لكل استدعاء
إدخال نصي متواضع؛ الإخراجات عبارة عن ملفات صوتية/صور/فيديو
التكلفة المالية
الدفع حسب الاستدعاء؛ الأرخص للبدء مع ما يعادل Flash/Hailuo-Mini
نصيحة
ادمج TTS القصير في عدد أقل من الاستدعاءات الأطول عندما يكون ذلك ممكنًا؛ الفيديو هو الأغلى ثمنًا — احفظ النتائج في الذاكرة المؤقتة.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: MINIMAX_API_KEY + MINIMAX_API_HOST مطابقة للمنطقة الجغرافية
تخزين بيانات الاعتماد: متغيرات البيئة
نقل البيانات الخارجي: يذهب نصك/صوتك إلى خوادم MiniMax في المنطقة المحددة
لا تمنح أبدًا: لا تمزج مفاتيح العالمية والبر الرئيسي — يسبب 'Invalid API key'

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

Invalid API key

يجب أن يتطابق المفتاح ومنطقة المضيف. اضبط MINIMAX_API_HOST=https://api.minimax.io للعالمية أو https://api.minimaxi.com للبر الرئيسي.

تحقق: env | grep MINIMAX
video generation never completes

استقصِ مع query_video_generation لمدة تصل إلى 10 دقائق؛ الأطول من المتوقع عادة يعني حمل الخادم. أعد المحاولة بمهمة جديدة إذا عُلقت.

voice_clone quality poor

يجب أن تكون عينة الصوت 10-60 ثانية، نظيفة (بدون موسيقى/ضوضاء)، متحدث واحد.

Rate limit exceeded

MiniMax تفرض حدود دقيقة ويومية. تراجع؛ قم بترقية الخطة للحصول على حدود أعلى.

البدائل

MiniMax-MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
ElevenLabs MCPعندما تريد TTS موجه نحو السوق الغربي مع أصوات إنجليزية مخصصةلا يوجد فيديو/صور/موسيقى في حزمة واحدة
OpenAI/Whisper for TTSعندما تكون لديك بالفعل أرصدة OpenAIخيارات صوت أقل من MiniMax

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills