MiniMax MCP

resmi

Berinteraksi dengan API Text-to-Speech, gambar, dan video generasi yang kuat dari MiniMax.

Apa yang bisa Anda lakukan dengan MiniMax MCP?

  • Teks ke ucapan — Minta asisten mengubah teks tertulis menjadi audio menggunakan suara yang ditentukan.
  • Kloning suara — Kloning suara dari file audio yang Anda berikan, lalu gunakan kembali untuk menghasilkan ucapan.
  • Desain suara — Hasilkan suara khusus dari prompt deskriptif dengan audio pratinjau.
  • Pembuatan dan pengeditan gambar — Buat gambar dari prompt dengan area 1K/2K/4K, atau edit gambar menggunakan prompt dan hingga 16 gambar referensi.
  • Pembuatan video — Hasilkan video dari prompt, dengan opsi durasi dan resolusi, lalu tanyakan hasil tugasnya setelah itu.

Dokumentasi

export

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

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

Dokumentasi

Mulai 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 lainnya.
  3. Penting: Host dan kunci API berbeda-beda menurut wilayah dan harus cocok; jika tidak, Anda akan mengalami kesalahan Invalid API key.
WilayahGlobalDaratan Utama
MINIMAX_API_KEYdapatkan dari MiniMax Globaldapatkan dari MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Buka Claude > Settings > Developer > Edit Config > claude_desktop_config.json untuk menyertakan konfigurasi 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", periksa host API Anda:

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

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

Cursor

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

Selesai. Kini klien MCP Anda dapat berinteraksi dengan MiniMax melalui alat-alat berikut:

Transportasi

Kami mendukung dua jenis transportasi: stdio dan sse.

stdioSSE
Jalankan secara lokalDapat diterapkan secara lokal atau di cloud
Komunikasi melalui stdoutKomunikasi melalui network
Input: Mendukung pemrosesan sumber daya local files atau URL yang validInput: Jika diterapkan di cloud, disarankan menggunakan URL sebagai input

Alat yang Tersedia

alatdeskripsi
text_to_audioMengubah teks menjadi audio dengan suara yang ditentukan
list_voicesMenampilkan daftar semua suara yang tersedia
voice_cloneMengkloning suara menggunakan berkas audio yang diberikan
generate_videoMembuat video dari prompt
text_to_imageMembuat gambar dari prompt. Secara default menggunakan MiniMax-H3-Image (mendukung area 1K/2K/4K dan size); image-01 tetap tersedia melalui model
image_editMengedit gambar dengan MiniMax-H3-Image menggunakan prompt dan 1-16 gambar referensi
query_video_generationMemeriksa hasil tugas pembuatan video
voice_designMembuat suara dari prompt menggunakan teks pratinjau

Catatan Rilis

10 November 2026

🆕 Yang Baru

  • Edit Gambar: Alat image_edit baru — edit gambar dengan MiniMax-H3-Image menggunakan prompt dan 1-16 gambar referensi (URL, URI data, mm_file://, atau jalur lokal)
  • Pembuatan Gambar H3: text_to_image kini secara default menggunakan MiniMax-H3-Image dan mendukung area (1K/2K/4K) serta size; image-01 tetap tersedia melalui parameter model

📈 Alat yang Disempurnakan

  • text_to_image - Secara default menggunakan MiniMax-H3-Image (/v1/images/generations); berikan model="image-01" untuk menggunakan model sebelumnya

2 Juli 2025

🆕 Yang Baru

  • Desain Suara: Alat voice_design baru - buat suara khusus dari prompt deskriptif dengan audio pratinjau
  • Peningkatan Video: Menambahkan model MiniMax-Hailuo-02 dengan kualitas sangat jernih serta kontrol durasi/resolusi

📈 Alat yang Disempurnakan

  • voice_design - Membuat suara yang dipersonalisasi dari deskripsi teks
  • generate_video - Kini mendukung MiniMax-Hailuo-02 dengan opsi durasi 6 dtk/10 dtk dan resolusi 768P/1080P

FAQ

1. kunci API tidak valid

Pastikan kunci API dan host API Anda sesuai dengan wilayah

WilayahGlobalDaratan Utama
MINIMAX_API_KEYdapatkan dari MiniMax Globaldapatkan dari MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

Pastikan jalur absolutnya dengan menjalankan perintah ini di terminal:

which uvx

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

3. Cara menggunakan generate_video dalam mode async

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

Contoh penggunaan

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

1. membacakan segmen berita malam

2. mengkloning suara

3. membuat video

4. membuat gambar