MiniMax MCP

MiniMax Model Context Protocol (MCP) sunucusu, güçlü Metin Konuşmaya ve video/görüntü oluşturma API'leriyle etkileşimi sağlar. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents gibi MCP istemcilerinin konuşma oluşturmasına, ses klonlamasına, video oluşturmasına, görüntü oluşturmasına ve daha fazlasına olanak tanır.

💡 Önerilen: MiniMax CLI (mmx-cli) — en yeni modeller ve metin, görüntü, arama ve müzik kapağı dahil ek özellikler sunan resmi komut satırı aracımız. Claude Code, Cursor, OpenClaw vb. için bir AI ajan becerisi olarak çalışır.

Dokümantasyon

• Çince Dokümantasyon
• MiniMax-MCP-JS - MiniMax MCP'nin resmi JavaScript uygulaması

MCP İstemcisi ile Hızlı Başlangıç

1. API anahtarınızı MiniMax adresinden alın.
2. uv (Python paket yöneticisi) kurun, curl -LsSf https://astral.sh/uv/install.sh | sh ile kurun veya ek kurulum 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şmelidir; aksi takdirde Invalid API key hatasıyla karşılaşırsınız.

Bölge	Global	Anakara
MINIMAX_API_KEY	MiniMax Global adresinden alın	MiniMax adresinden alın
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Claude > Settings > Developer > Edit Config > claude_desktop_config.json adresine giderek aşağıdakileri ekleyin:

{
  "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ı ana bilgisayarla eşleşmelidir. "API Error: invalid api key" hatası oluşursa, lütfen API ana bilgisayarınızı kontrol edin:

• Global Ana Bilgisayar：https://api.minimax.io
• Anakara Ana Bilgisayar：https://api.minimaxi.com

Windows kullanıyorsanız, MCP sunucusunu kullanmak için Claude Desktop'ta "Geliştirici Modu"nu etkinleştirmeniz gerekecektir. Sol üstteki hamburger menüsünde "Yardım"a tıklayın ve "Geliştirici Modunu Etkinleştir"i seçin.

Cursor

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

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

Taşıma

İki taşıma türünü destekliyoruz: stdio ve sse.

stdio	SSE
Yerel olarak çalıştırın	Yerel olarak veya bulutta dağıtılabilir
stdout üzerinden iletişim	network üzerinden iletişim
Girdi: local files veya geçerli URL kaynaklarının işlenmesini destekler	Girdi: Bulutta dağıtıldığında, girdi için URL kullanılması önerilir

Kullanılabilir Araçlar

Araç	Açıklama
text_to_audio	Verilen bir sesle metni sese dönüştürün
list_voices	Mevcut tüm sesleri listele
voice_clone	Sağlanan ses dosyalarını kullanarak bir sesi klonlayın
generate_video	Bir istemden video oluşturun
text_to_image	Bir istemden görüntü oluşturun
query_video_generation	Video oluşturma görevinin sonucunu sorgulayın
music_generation	Bir istem ve şarkı sözlerinden müzik parçası oluşturun
voice_design	Önizleme metni kullanarak bir istemden ses oluşturun

Sürüm Notları

2 Temmuz 2025

🆕 Yenilikler

• Ses Tasarımı: Yeni voice_design aracı - önizleme sesiyle açıklayıcı istemlerden özel sesler oluşturun
• Video Geliştirme: Ultra net kalite ve süre/çözünürlük kontrolleriyle MiniMax-Hailuo-02 modeli eklendi
• Müzik Oluşturma: music-1.5 modeliyle güçlendirilmiş music_generation aracı geliştirildi

📈 Geliştirilmiş Araçlar

• voice_design - Metin açıklamalarından kişiselleştirilmiş sesler oluşturun
• generate_video - Artık 6s/10s süre ve 768P/1080P çözünürlük seçenekleriyle MiniMax-Hailuo-02'yi destekliyor
• music_generation - music-1.5 modeliyle yüksek kaliteli müzik oluşturma

SSS

1. geçersiz api anahtarı

Lütfen API anahtarınızın ve API ana bilgisayarınızın bölgesel olarak uyumlu olduğundan emin olun

Bölge	Global	Anakara
MINIMAX_API_KEY	MiniMax Global adresinden alın	MiniMax adresinden alın
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Lütfen terminalinizde şu komutu çalıştırarak mutlak yolunu doğrulayın:

which uvx

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

3. generate_video async modda nasıl kullanılır

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

Örnek kullanım

⚠️ Uyarı: Bu araçları kullanmak maliyet doğurabilir.

1. akşam haberlerinden bir bölüm yayınlayın

2. bir sesi klonlayın

3. bir video oluşturun

4. görüntüler oluşturun