MiniMax MCP

resmi

MiniMax'in güçlü Metin-konuşma, görüntü ve video üretim API'leriyle etkileşim kurun.

MiniMax MCP ile neler yapabilirsiniz?

  • Metinden konuşmaya — Asistandan, yazılı metni belirtilen bir sesi kullanarak sese dönüştürmesini isteyin.
  • Ses klonlama — Sağladığınız ses dosyalarından bir sesi klonlayın, ardından konuşma üretiminde yeniden kullanın.
  • Ses tasarımı — Önizleme sesiyle birlikte açıklayıcı bir istemden özel bir ses oluşturun.
  • Görsel oluşturma ve düzenleme — İstemlerden 1K/2K/4K boyutlarında görseller oluşturun veya bir istem ve en fazla 16 referans görseli kullanarak bir görseli düzenleyin.
  • Video oluşturma — Süre ve çözünürlük seçenekleriyle bir istemden video oluşturun ve ardından görev sonucunu sorgulayın.

Dokümantasyon

export

Güçlü Metinden Konuşmaya ve video/görüntü oluşturma API'leriyle etkileşim kurulmasını sağlayan resmi MiniMax Model Context Protocol (MCP) sunucusu. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents ve diğerleri gibi MCP istemcilerinin konuşma oluşturmasına, sesleri klonlamasına, video ve görüntü oluşturmasına ve daha fazlasını yapmasına olanak tanır.

💡 Önerilen: MiniMax CLI (mmx-cli) — en yeni modelleri ve metin, görsel ve arama özellikleri dahil ek özellikleri sunan resmi komut satırı aracımız. Claude Code, Cursor, OpenClaw vb. için bir yapay zekâ ajanı becerisi olarak çalışır.

Belgeler

MCP İstemcisiyle Hızlı Başlangıç

  1. API anahtarınızı MiniMax üzerinden alın.
  2. uv (Python paket yöneticisi) aracını yükleyin, curl -LsSf https://astral.sh/uv/install.sh | sh ile yükleyin veya ek yükleme yöntemleri için uv deposuna bakın.
  3. Önemli: API ana bilgisayarı ve anahtar bölgeye göre değişir ve eşleşmeleri gerekir; aksi takdirde Invalid API key hatasıyla karşılaşırsınız.
BölgeGlobalMainland
MINIMAX_API_KEYMiniMax Global üzerinden alınMiniMax üzerinden alın
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Aşağıdakileri eklemek için Claude > Settings > Developer > Edit Config > claude_desktop_config.json adresine gidin:

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

⚠️ Uyarı: API anahtarının ana bilgisayarla eşleşmesi gerekir. "API Error: invalid api key" hatası oluşursa lütfen API ana bilgisayarınızı kontrol edin:

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

Windows kullanıyorsanız MCP sunucusunu kullanmak için Claude Desktop'ta "Developer Mode" seçeneğini etkinleştirmeniz gerekir. Sol üstteki hamburger menüsünden "Help" seçeneğine tıklayın ve "Enable Developer Mode" seçeneğini belirleyin.

Cursor

Yukarıdaki yapılandırmayı eklemek için Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server adresine gidin.

Hepsi bu kadar. MCP istemciniz artık bu araçlar aracılığıyla MiniMax ile etkileşim kurabilir:

Aktarım

İki aktarım türünü destekliyoruz: stdio ve sse.

stdioSSE
Yerel olarak çalıştırılırYerel olarak veya bulutta dağıtılabilir
stdout üzerinden iletişimnetwork üzerinden iletişim
Girdi: local files veya geçerli URL kaynaklarını işlemeyi desteklerGirdi: Bulutta dağıtıldığında, girdi için URL kullanılması önerilir

Kullanılabilir Araçlar

araçaçıklama
text_to_audioBelirtilen bir sesle metni sese dönüştürür
list_voicesKullanılabilir tüm sesleri listeler
voice_cloneSağlanan ses dosyalarını kullanarak bir sesi klonlar
generate_videoBir istemden video oluşturur
text_to_imageBir istemden görüntü oluşturur. Varsayılan olarak MiniMax-H3-Image kullanılır (area 1K/2K/4K ve size desteklenir); image-01 hâlâ model aracılığıyla kullanılabilir
image_editBir istem ve 1-16 referans görüntü kullanarak MiniMax-H3-Image ile görüntü düzenler
query_video_generationVideo oluşturma görevinin sonucunu sorgular
voice_designÖnizleme metni kullanarak bir istemden ses oluşturur

Sürüm Notları

10 Kasım 2026

🆕 Yenilikler

  • Görüntü Düzenleme: Yeni image_edit aracı — bir istem ve 1-16 referans görüntü (URL, veri URI'si, mm_file:// veya yerel yol) kullanarak MiniMax-H3-Image ile görüntüleri düzenleyin
  • H3 Görüntü Oluşturma: text_to_image artık varsayılan olarak MiniMax-H3-Image kullanıyor ve area (1K/2K/4K) ile size desteği sunuyor; image-01, model parametresi aracılığıyla kullanılmaya devam ediyor

📈 Geliştirilmiş Araçlar

  • text_to_image - Varsayılan olarak MiniMax-H3-Image kullanır (/v1/images/generations); önceki modeli kullanmak için model="image-01" iletin

2 Temmuz 2025

🆕 Yenilikler

  • Ses Tasarımı: Yeni voice_design aracı - açıklayıcı istemlerden önizleme sesiyle özel sesler oluşturun
  • Video Geliştirme: Üstün netlikte kalite ve süre/çözünürlük kontrolleri sunan MiniMax-Hailuo-02 modeli eklendi

📈 Geliştirilmiş Araçlar

  • voice_design - Metin açıklamalarından kişiselleştirilmiş sesler oluşturur
  • generate_video - Artık 6s/10s süre ve 768P/1080P çözünürlük seçenekleriyle MiniMax-Hailuo-02'yi destekliyor

SSS

1. geçersiz API anahtarı

Lütfen API anahtarınızın ve API ana bilgisayarınızın bölge bakımından eşleştiğinden emin olun

BölgeGlobalMainland
MINIMAX_API_KEYMiniMax Global üzerinden alınMiniMax üzerinden alın
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

Terminalinizde şu komutu çalıştırarak mutlak yolu doğrulayın:

which uvx

Mutlak yolu öğrendikten sonra (ör. /usr/local/bin/uvx), yapılandırmanızı bu yolu kullanacak şekilde güncelleyin (ör. "command": "/usr/local/bin/uvx").

3. Async modunda generate_video nasıl kullanılır?

Başlamadan önce tamamlanma kurallarını tanımlayın: Alternatif olarak bu kurallar IDE ayarlarınızda (ör. Cursor) yapılandırılabilir:

Kullanım örnekleri

⚠️ Uyarı: Bu araçların kullanımı ücret doğurabilir.

1. akşam haberlerinin bir bölümünü seslendirme

2. bir sesi klonlama

3. video oluşturma

4. görüntü oluşturma