MiniMax MCP Server

Güçlü Metin Okuma ve video/görüntü oluşturma API'larıyla etkileşim sağlayan resmi MiniMax Model Bağlam Protokolü (MCP) sunucusu. Bu sunucu, Claude Desktop, Cursor, Windsurf, OpenAI Agents ve diğerleri gibi MCP istemcilerinin konuşma üretmesine, 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 cover'ı gibi 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

• 中文文档
• MiniMax-MCP-JS - MiniMax MCP'nin resmi JavaScript uygulaması

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

1. API anahtarınızı MiniMax adresinden edinin.
2. uv (Python paket yöneticisi) yükleyin, 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

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 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.

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

Aktarım

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

stdio	SSE
Yerel olarak çalışır	Yerel olarak veya bulutta dağıtılabilir
stdout aracılığıyla iletişim	network aracılığıyla 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

Mevcut Araçlar

araç	açıklama
text_to_audio	Belirli bir sesle metni sese dönüştür
list_voices	Mevcut tüm sesleri listele
voice_clone	Sağlanan ses dosyalarını kullanarak bir sesi klonla
generate_video	Bir komuttan video oluştur
text_to_image	Bir komuttan görüntü oluştur
query_video_generation	Video oluşturma görevinin sonucunu sorgula
music_generation	Bir komut ve şarkı sözlerinden müzik parçası oluştur
voice_design	Önizleme metni kullanarak bir komuttan ses oluştur

Sürüm Notları

2 Temmuz 2025

🆕 Yenilikler

• Ses Tasarımı: Yeni voice_design aracı - önizleme sesiyle açıklayıcı komutlardan özel sesler oluşturun
• Video Geliştirme: Ultra net kalite ve süre/çözünürlük kontrollerine sahip MiniMax-Hailuo-02 modeli eklendi
• Müzik Üretimi: 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 bu komutu çalıştırarak mutlak yolunu doğrulayın:

which uvx

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

3. generate_video eşzamansız 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 maliyete yol açabilir.

1. bir akşam haber bölümünü yayınla

2. bir sesi klonla

3. bir video oluştur

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