MiniMax MCP

Offizieller MiniMax Model Context Protocol (MCP)-Server, der die Interaktion mit leistungsstarken Text-to-Speech- und Video-/Bildgenerierungs-APIs ermöglicht. Dieser Server erlaubt es MCP-Clients wie Claude Desktop, Cursor, Windsurf, OpenAI Agents und anderen, Sprache zu erzeugen, Stimmen zu klonen, Videos zu generieren, Bilder zu generieren und mehr.

💡 Empfohlen: MiniMax CLI (mmx-cli) — unser offizielles Kommandozeilen-Tool mit den neuesten Modellen und zusätzlichen Funktionen wie Text, Vision und Suche. Funktioniert als KI-Agenten-Fähigkeit für Claude Code, Cursor, OpenClaw usw.

Dokumentation

• 中文文档
• MiniMax-MCP-JS - Offizielle JavaScript-Implementierung von MiniMax MCP

Schnellstart mit MCP-Client

1. Holen Sie sich Ihren API-Schlüssel von MiniMax.
2. Installieren Sie uv (Python-Paketmanager), installieren Sie mit curl -LsSf https://astral.sh/uv/install.sh | sh oder sehen Sie sich das uv Repository für weitere Installationsmethoden an.
3. Wichtig: Der API-Host und der Schlüssel variieren je nach Region und müssen übereinstimmen; andernfalls erhalten Sie einen Invalid API key-Fehler.

Region	Global	Festland
MINIMAP_API_KEY	Holen Sie sich von MiniMax Global	Holen Sie sich von MiniMax
MINIMAP_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

Gehen Sie zu Claude > Settings > Developer > Edit Config > claude_desktop_config.json, um Folgendes einzufügen:

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

⚠️ Warnung: Der API-Schlüssel muss zum Host passen. Wenn ein Fehler "API Error: invalid api key" auftritt, überprüfen Sie bitte Ihren API-Host:

• Globaler Host: https://api.minimax.io
• Festland-Host: https://api.minimaxi.com

Wenn Sie Windows verwenden, müssen Sie den "Entwicklermodus" in Claude Desktop aktivieren, um den MCP-Server zu nutzen. Klicken Sie auf "Hilfe" im Hamburger-Menü oben links und wählen Sie "Entwicklermodus aktivieren".

Cursor

Gehen Sie zu Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server, um die obige Konfiguration hinzuzufügen.

Das war's. Ihr MCP-Client kann jetzt über diese Tools mit MiniMax interagieren:

Transport

Wir unterstützen zwei Transportarten: stdio und sse.

stdio	SSE
Lokal ausführen	Kann lokal oder in der Cloud bereitgestellt werden
Kommunikation über stdout	Kommunikation über network
Eingabe: Unterstützt die Verarbeitung von local files oder gültigen URL-Ressourcen	Eingabe: Bei Bereitstellung in der Cloud wird empfohlen, URL für die Eingabe zu verwenden

Verfügbare Tools

tool	Beschreibung
text_to_audio	Text mit einer bestimmten Stimme in Audio umwandeln
list_voices	Alle verfügbaren Stimmen auflisten
voice_clone	Eine Stimme mit bereitgestellten Audiodateien klonen
generate_video	Ein Video aus einer Eingabeaufforderung generieren
text_to_image	Ein Bild aus einer Eingabeaufforderung generieren
query_video_generation	Das Ergebnis einer Video-Generierungsaufgabe abfragen
voice_design	Eine Stimme aus einer Eingabeaufforderung mit Vorschautext generieren

Versionshinweise

2. Juli 2025

🆕 Was ist neu

• Stimmdesign: Neues voice_design-Tool - erstellen Sie benutzerdefinierte Stimmen aus beschreibenden Eingabeaufforderungen mit Vorschau-Audio
• Video-Verbesserung: MiniMax-Hailuo-02-Modell mit ultraklarer Qualität und Dauer-/Auflösungssteuerung hinzugefügt

📈 Verbesserte Tools

• voice_design - Personalisierte Stimmen aus Textbeschreibungen generieren
• generate_video - Unterstützt jetzt MiniMax-Hailuo-02 mit 6s/10s Dauer und 768P/1080P Auflösungsoptionen

FAQ

1. invalid api key

Bitte stellen Sie sicher, dass Ihr API-Schlüssel und API-Host regional übereinstimmen

Region	Global	Festland
MINIMAP_API_KEY	Holen Sie sich von MiniMax Global	Holen Sie sich von MiniMax
MINIMAP_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

Bitte bestätigen Sie den absoluten Pfad, indem Sie diesen Befehl in Ihrem Terminal ausführen:

which uvx

Sobald Sie den absoluten Pfad erhalten (z. B. /usr/local/bin/uvx), aktualisieren Sie Ihre Konfiguration, um diesen Pfad zu verwenden (z. B. "command": "/usr/local/bin/uvx").

3. Wie verwende ich generate_video im Async-Modus

Definieren Sie Abschlussregeln, bevor Sie beginnen: Alternativ können diese Regeln in Ihren IDE-Einstellungen (z. B. Cursor) konfiguriert werden:

Beispielverwendung

⚠️ Warnung: Die Verwendung dieser Tools kann Kosten verursachen.

1. Einen Abschnitt der Abendnachrichten senden

2. Eine Stimme klonen

3. Ein Video generieren

4. Bilder generieren