MiniMax MCP Server

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 generieren, 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, einschließlich Text, Vision, Suche und Musikcover. Funktioniert als KI-Agenten-Skill 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 Repo für zusätzliche Installationsmethoden an.
3. Wichtig: Der API-Host und -Schlüssel variieren je nach Region und müssen übereinstimmen; andernfalls erhalten Sie einen Invalid API key-Fehler.

Region	Global	Festland
MINIMAX_API_KEY	holen von MiniMax Global	holen von MiniMax
MINIMAX_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 der 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 nun über diese Werkzeuge mit MiniMax interagieren:

Transport

Wir unterstützen zwei Transporttypen: 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 Cloud-Bereitstellung wird die Verwendung von URL für die Eingabe empfohlen

Verfügbare Werkzeuge

Werkzeug	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 Videogenerierungsaufgabe abfragen
music_generation	Einen Musiktitel aus einer Eingabeaufforderung und Liedtext generieren
voice_design	Eine Stimme aus einer Eingabeaufforderung mit Vorschautext generieren

Versionshinweise

2. Juli 2025

🆕 Neuigkeiten

• Stimmdesign: Neues voice_design-Werkzeug - Erstellen Sie benutzerdefinierte Stimmen aus beschreibenden Eingabeaufforderungen mit Vorschau-Audio
• Video-Verbesserung: Hinzugefügtes MiniMax-Hailuo-02-Modell mit ultraklarer Qualität und Steuerung von Dauer/Auflösung
• Musikgenerierung: Verbessertes music_generation-Werkzeug, unterstützt durch das music-1.5-Modell

📈 Verbesserte Werkzeuge

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

FAQ

1. invalid api key

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

Region	Global	Festland
MINIMAX_API_KEY	holen von MiniMax Global	holen von MiniMax
MINIMAX_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 haben (z. B. /usr/local/bin/uvx), aktualisieren Sie Ihre Konfiguration, um diesen Pfad zu verwenden (z. B. "command": "/usr/local/bin/uvx").

3. Wie verwendet man generate_video im asynchronen Modus

Definieren Sie die Abschlussregeln vor dem Start: Alternativ können diese Regeln in Ihren IDE-Einstellungen konfiguriert werden (z. B. Cursor):

Beispielnutzung

⚠️ Warnung: Die Nutzung dieser Werkzeuge kann Kosten verursachen.

1. Einen Abschnitt der Abendnachrichten senden

2. Eine Stimme klonen

3. Ein Video generieren

4. Bilder generieren