MiniMax MCP

officiel

Interagir avec les puissantes API de génération Text-to-Speech, d'images et de vidéos de MiniMax.

Que pouvez-vous faire avec MiniMax MCP ?

  • Synthèse vocale — Demandez à l’assistant de convertir du texte écrit en audio avec une voix spécifiée.
  • Clonage vocal — Clonez une voix à partir des fichiers audio que vous fournissez, puis réutilisez-la pour générer de la parole.
  • Conception vocale — Générez une voix personnalisée à partir d’une description, avec un aperçu audio.
  • Génération et retouche d’images — Créez des images à partir de prompts dans des zones de 1K/2K/4K, ou retouchez une image à l’aide d’un prompt et de jusqu’à 16 images de référence.
  • Génération vidéo — Générez une vidéo à partir d’un prompt, avec des options de durée et de résolution, puis consultez le résultat de la tâche.

Documentation

export

Serveur officiel MiniMax Model Context Protocol (MCP) permettant d’interagir avec de puissantes API de synthèse vocale et de génération de vidéos/images. Ce serveur permet aux clients MCP tels que Claude Desktop, Cursor, Windsurf, OpenAI Agents et d’autres de générer de la parole, de cloner des voix, de générer des vidéos et des images, et bien plus encore.

💡 Recommandé : MiniMax CLI (mmx-cli) — notre outil officiel en ligne de commande, qui propose les derniers modèles et des fonctionnalités supplémentaires, notamment le texte, la vision et la recherche. Fonctionne comme compétence d’agent IA pour Claude Code, Cursor, OpenClaw, etc.

Documentation

Démarrage rapide avec un client MCP

  1. Obtenez votre clé API auprès de MiniMax.
  2. Installez uv (gestionnaire de paquets Python), puis installez avec curl -LsSf https://astral.sh/uv/install.sh | sh ou consultez le dépôt uv pour découvrir d’autres méthodes d’installation.
  3. Important : l’hôte et la clé API varient selon la région et doivent correspondre ; sinon, vous rencontrerez une erreur Invalid API key.
RégionGlobalChine continentale
MINIMAX_API_KEYà obtenir auprès de MiniMax Globalà obtenir auprès de MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

Claude Desktop

Accédez à Claude > Settings > Developer > Edit Config > claude_desktop_config.json pour inclure ce qui suit :

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

⚠️ Avertissement : la clé API doit correspondre à l’hôte. Si l’erreur « API Error: invalid api key » se produit, veuillez vérifier votre hôte API :

  • Hôte global:https://api.minimax.io
  • Hôte Chine continentale:https://api.minimaxi.com

Sous Windows, vous devez activer le « Mode développeur » dans Claude Desktop pour utiliser le serveur MCP. Cliquez sur « Aide » dans le menu hamburger en haut à gauche, puis sélectionnez « Activer le mode développeur ».

Cursor

Accédez à Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server pour ajouter la configuration ci-dessus.

Voilà, votre client MCP peut maintenant interagir avec MiniMax à l’aide de ces outils :

Transport

Nous prenons en charge deux types de transport : stdio et sse.

stdioSSE
Exécution localePeut être déployé localement ou dans le cloud
Communication via stdoutCommunication via network
Entrée : prend en charge le traitement de ressources local files ou URL validesEntrée : en cas de déploiement dans le cloud, il est recommandé d’utiliser URL pour l’entrée

Outils disponibles

outildescription
text_to_audioConvertir du texte en audio avec une voix donnée
list_voicesRépertorier toutes les voix disponibles
voice_cloneCloner une voix à partir des fichiers audio fournis
generate_videoGénérer une vidéo à partir d’une invite
text_to_imageGénérer une image à partir d’une invite. Utilise MiniMax-H3-Image par défaut (prend en charge area 1K/2K/4K et size) ; image-01 reste disponible via model
image_editModifier une image avec MiniMax-H3-Image à l’aide d’une invite et de 1 à 16 images de référence
query_video_generationInterroger le résultat d’une tâche de génération vidéo
voice_designGénérer une voix à partir d’une invite à l’aide d’un texte d’aperçu

Notes de version

10 novembre 2026

🆕 Nouveautés

  • Modification d’image : nouvel outil image_edit — modifier des images avec MiniMax-H3-Image à l’aide d’une invite et de 1 à 16 images de référence (URL, URI de données, mm_file:// ou chemin local)
  • Génération d’images H3 : text_to_image utilise désormais MiniMax-H3-Image par défaut et prend en charge area (1K/2K/4K) et size ; image-01 reste disponible via le paramètre model

📈 Outils améliorés

  • text_to_image - Utilise MiniMax-H3-Image par défaut (/v1/images/generations) ; transmettez model="image-01" pour utiliser le modèle précédent

2 juillet 2025

🆕 Nouveautés

  • Conception de voix : nouvel outil voice_design - créer des voix personnalisées à partir d’invites descriptives avec un aperçu audio
  • Amélioration vidéo : ajout du modèle MiniMax-Hailuo-02 avec une qualité ultra-nette et des commandes de durée/résolution

📈 Outils améliorés

  • voice_design - Générer des voix personnalisées à partir de descriptions textuelles
  • generate_video - Prend désormais en charge MiniMax-Hailuo-02 avec des options de durée de 6 s/10 s et de résolution 768P/1080P

FAQ

1. Clé API invalide

Veuillez vérifier que votre clé API et votre hôte API correspondent à la même région.

RégionGlobalChine continentale
MINIMAX_API_KEYà obtenir auprès de MiniMax Globalà obtenir auprès de MiniMax
MINIMAX_API_HOSThttps://api.minimax.iohttps://api.minimaxi.com

2. spawn uvx ENOENT

Veuillez confirmer son chemin absolu en exécutant cette commande dans votre terminal :

which uvx

Une fois le chemin absolu obtenu (par exemple, /usr/local/bin/uvx), mettez à jour votre configuration pour utiliser ce chemin (par exemple, "command": "/usr/local/bin/uvx").

3. Comment utiliser generate_video en mode asynchrone

Définissez les règles d’achèvement avant de commencer : Vous pouvez également configurer ces règles dans les paramètres de votre IDE (par exemple, Cursor) :

Exemples d’utilisation

⚠️ Avertissement : l’utilisation de ces outils peut entraîner des frais.

1. Diffuser un extrait du journal télévisé du soir

2. Cloner une voix

3. Générer une vidéo

4. Générer des images