MiniMax MCP

Server MiniMax MCP (Model Context Protocol) resmi yang memungkinkan interaksi dengan API Text to Speech serta pembuatan video/gambar yang canggih. Server ini memungkinkan klien MCP seperti Claude Desktop, Cursor, Windsurf, OpenAI Agents dan lainnya untuk menghasilkan ucapan, mengkloning suara, menghasilkan video, menghasilkan gambar, dan banyak lagi.

💡 Disarankan: MiniMax CLI (mmx-cli) — alat baris perintah resmi kami dengan model terbaru dan fitur tambahan termasuk teks, visi, pencarian, dan sampul musik. Berfungsi sebagai keterampilan agen AI untuk Claude Code, Cursor, OpenClaw, dll.

Dokumentasi

• 中文文档
• MiniMax-MCP-JS - Implementasi JavaScript resmi dari MiniMax MCP

Memulai Cepat dengan Klien MCP

1. Dapatkan kunci API Anda dari MiniMax.
2. Instal uv (pengelola paket Python), instal dengan curl -LsSf https://astral.sh/uv/install.sh | sh atau lihat uv repo untuk metode instalasi tambahan.
3. Penting: Host dan kunci API bervariasi berdasarkan wilayah dan harus cocok; jika tidak, Anda akan mengalami kesalahan Invalid API key.

Wilayah	Global	Daratan
MINIMAP_API_KEY	dapatkan dari MiniMax Global	dapatkan dari MiniMax
MINIMAP_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json untuk menyertakan yang berikut:

{
  "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"
      }
    }
  }
}

⚠️ Peringatan: Kunci API harus cocok dengan host. Jika terjadi kesalahan "API Error: invalid api key", harap periksa host API Anda:

• Host Global：https://api.minimax.io
• Host Daratan：https://api.minimaxi.com

Jika Anda menggunakan Windows, Anda harus mengaktifkan "Developer Mode" di Claude Desktop untuk menggunakan server MCP. Klik "Help" di menu hamburger di kiri atas dan pilih "Enable Developer Mode".

Cursor

Buka Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server untuk menambahkan konfigurasi di atas.

Itu saja. Klien MCP Anda sekarang dapat berinteraksi dengan MiniMax melalui alat-alat ini:

Transport

Kami mendukung dua jenis transport: stdio dan sse.

stdio	SSE
Dijalankan secara lokal	Dapat digunakan secara lokal atau di cloud
Komunikasi melalui stdout	Komunikasi melalui network
Input: Mendukung pemrosesan local files atau sumber daya URL yang valid	Input: Saat digunakan di cloud, disarankan menggunakan URL untuk input

Alat yang Tersedia

alat	deskripsi
text_to_audio	Mengubah teks menjadi audio dengan suara tertentu
list_voices	Mencantumkan semua suara yang tersedia
voice_clone	Mengkloning suara menggunakan file audio yang disediakan
generate_video	Menghasilkan video dari prompt
text_to_image	Menghasilkan gambar dari prompt
query_video_generation	Menanyakan hasil tugas pembuatan video
music_generation	Menghasilkan trek musik dari prompt dan lirik
voice_design	Menghasilkan suara dari prompt menggunakan teks pratinjau

Catatan Rilis

2 Juli 2025

🆕 Apa yang Baru

• Desain Suara: Alat voice_design baru - buat suara kustom dari prompt deskriptif dengan audio pratinjau
• Peningkatan Video: Menambahkan model MiniMax-Hailuo-02 dengan kualitas ultra-jelas serta kontrol durasi/resolusi
• Pembuatan Musik: Alat music_generation yang ditingkatkan didukung oleh model music-1.5

📈 Alat yang Ditingkatkan

• voice_design - Hasilkan suara yang dipersonalisasi dari deskripsi teks
• generate_video - Sekarang mendukung MiniMax-Hailuo-02 dengan durasi 6s/10s dan opsi resolusi 768P/1080P
• music_generation - Pembuatan musik berkualitas tinggi dengan model music-1.5

FAQ

1. invalid api key

Pastikan kunci API dan host API Anda selaras secara regional

Wilayah	Global	Daratan
MINIMAP_API_KEY	dapatkan dari MiniMax Global	dapatkan dari MiniMax
MINIMAP_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Harap konfirmasi jalur absolutnya dengan menjalankan perintah ini di terminal Anda:

which uvx

Setelah Anda mendapatkan jalur absolut (misalnya, /usr/local/bin/uvx), perbarui konfigurasi Anda untuk menggunakan jalur tersebut (misalnya, "command": "/usr/local/bin/uvx").

3. Cara menggunakan generate_video dalam mode async

Tentukan aturan penyelesaian sebelum memulai: Alternatifnya, aturan ini dapat dikonfigurasi di pengaturan IDE Anda (misalnya, Cursor):

Contoh penggunaan

⚠️ Peringatan: Menggunakan alat-alat ini dapat menimbulkan biaya.

1. menyiarkan segmen berita malam

2. mengkloning suara

3. menghasilkan video

4. menghasilkan gambar