MiniMax

简介

官方 MiniMax 模型上下文协议 (MCP) 服务器，支持与强大的文本转语音和视频/图像生成 API 进行交互。该服务器允许Claude Desktop、Cursor、Windsurf、OpenAI Agents等 MCP 客户端生成语音、克隆声音、生成视频、生成图像等。

简介

官方 MiniMax 模型上下文协议 (MCP) 服务器，支持与强大的文本转语音和视频/图像生成 API 进行交互。该服务器允许Claude Desktop、Cursor、Windsurf、OpenAI Agents等 MCP 客户端生成语音、克隆声音、生成视频、生成图像等。

English Version

MiniMax官方模型上下文协议(MCP)服务器，支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude Desktop、Cursor、Windsurf、OpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。

Documentation

• English Documentation
• MiniMax-MCP-JS - MiniMax MCP的官方JavaScript版本

快速开始使用 MCP 客户端

1. 从MiniMax国内开放平台｜MiniMax国际开放平台获取你的 API 密钥。
2. 安装uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv 仓库获取其他安装方法。
3. 重要提示: API的服务器地址和密钥在不同区域有所不同，两者需要匹配，否则会有 invalid api key 的错误

Claude Desktop

前往Claude > Settings > Developer > Edit Config > claude_desktop_config.json包含以下内容：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "填写你的API密钥",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop",
        "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io",
        "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
      }
    }
  }
}

⚠️ 注意：API Key需要与Host匹配。如果出现"API Error: invalid api key"错误，请检查您的API Host：

• 国际版Host：https://api.minimax.io
• 国内版Host：https://api.minimaxi.com

如果你使用Windows，你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help"，然后选择"Enable Developer Mode"。

Cursor

前往Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server添加上述配置。

你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互：

Transport

我们支持两种传输方式: stdio and sse.

可用方法

更新日志

2025年7月2日

🆕 新增功能

• 音色设计: 新增 voice_design 工具 - 根据描述性提示词创建自定义音色并生成试听音频
• 视频生成增强: 新增 MiniMax-Hailuo-02 模型，支持超清画质和时长/分辨率控制
• 音乐生成: 采用 music-1.5 模型增强 music_generation 工具

📈 功能增强

• voice_design - 根据文本描述生成个性化音色
• generate_video - 现在支持 MiniMax-Hailuo-02 模型，可选择 6s/10s 时长和 768P/1080P 分辨率
• music_generation - 采用 music-1.5 模型进行高质量音乐创作

FAQ

1. invalid api key

请检查你获取的 API Key 和填写的 API Host 是否是同一地区的：

2. spawn uvx ENOENT

请在你的终端输入一下命令，查看uvx命令的绝对路径：

which uvx

如果得到如下的输出 (如：/usr/local/bin/uvx)，更新mcp配置 ("command": "/usr/local/bin/uvx").

3. 如何用 generate_video 工具异步生成视频

在对话前设置一些规则: 或者放到本地客户端的规则中 (以 Cursor 为例):

使用示例

⚠️ 注意：使用这些工具可能会产生费用。

1. 播报晚间新闻片段

2. 克隆声音

3. 生成视频

4. 生成图像

工具列表

• text_to_audio: Convert text to audio with a given voice and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Voice id is optional, if not provided, the default voice will be used.

  COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user.

  Args: text (str): The text to convert to speech. voice_id (str, optional): The id of the voice to use. For example, "male-qn-qingse"/"audiobook_female_1"/"cute_boy"/"Charming_Lady"... model (string, optional): The model to use. speed (float, optional): Speed of the generated audio. Controls the speed of the generated speech. Values range from 0.5 to 2.0, with 1.0 being the default speed. vol (float, optional): Volume of the generated audio. Controls the volume of the generated speech. Values range from 0 to 10, with 1 being the default volume. pitch (int, optional): Pitch of the generated audio. Controls the speed of the generated speech. Values range from -12 to 12, with 0 being the default speed. emotion (str, optional): Emotion of the generated audio. Controls the emotion of the generated speech. Values range ["happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral"], with "happy" being the default emotion. sample_rate (int, optional): Sample rate of the generated audio. Controls the sample rate of the generated speech. Values range [8000,16000,22050,24000,32000,44100] with 32000 being the default sample rate. bitrate (int, optional): Bitrate of the generated audio. Controls the bitrate of the generated speech. Values range [32000,64000,128000,256000] with 128000 being the default bitrate. channel (int, optional): Channel of the generated audio. Controls the channel of the generated speech. Values range [1, 2] with 1 being the default channel. format (str, optional): Format of the generated audio. Controls the format of the generated speech. Values range ["pcm", "mp3","flac"] with "mp3" being the default format. language_boost (str, optional): Language boost of the generated audio. Controls the language boost of the generated speech. Values range ['Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'auto'] with "auto" being the default language boost. Returns: Text content with the path to the output file and name of the voice used.

• list_voices: List all voices available. Only supports when api_host is https://api.minimax.chat

  Args: voice_type (str, optional): The type of voices to list. Values range ["all", "system", "voice_cloning"], with "all" being the default. Returns: Text content with the list of voices.

• voice_clone: Clone a voice using provided audio files. The new voice will be charged upon first use.

  COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user.

  Args: voice_id (str): The id of the voice to use. file (str): The path to the audio file to clone or a URL to the audio file. text (str, optional): The text to use for the demo audio. is_url (bool, optional): Whether the file is a URL. Defaults to False. Returns: Text content with the voice id of the cloned voice.

• play_audio: Play an audio file. Supports WAV and MP3 formats. Not supports video.

  Args: input_file_path (str): The path to the audio file to play. is_url (bool, optional): Whether the audio file is a URL. Returns: Text content with the path to the audio file.

• generate_video: Generate a video from a prompt.

  COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user.

  Args: model (str, optional): The model to use. Values range ["T2V-01", "T2V-01-Director", "I2V-01", "I2V-01-Director", "I2V-01-live"]. "Director" supports inserting instructions for camera movement control. "I2V" for image to video. "T2V" for text to video. prompt (str): The prompt to generate the video from. When use Director model, the prompt supports 15 Camera Movement Instructions (Enumerated Values) -Truck: [Truck left], [Truck right] -Pan: [Pan left], [Pan right] -Push: [Push in], [Pull out] -Pedestal: [Pedestal up], [Pedestal down] -Tilt: [Tilt up], [Tilt down] -Zoom: [Zoom in], [Zoom out] -Shake: [Shake] -Follow: [Tracking shot] -Static: [Static shot] first_frame_image (str): The first frame image. The model must be "I2V" Series. output_directory (str, optional): The directory to save the video to. Returns: Text content with the path to the output video file.

• text_to_image: Generate a image from a prompt.

  COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user.

  Args: model (str, optional): The model to use. Values range ["image-01"], with "image-01" being the default. prompt (str): The prompt to generate the image from. aspect_ratio (str, optional): The aspect ratio of the image. Values range ["1:1", "16:9","4:3", "3:2", "2:3", "3:4", "9:16", "21:9"], with "1:1" being the default. n (int, optional): The number of images to generate. Values range [1, 9], with 1 being the default. prompt_optimizer (bool, optional): Whether to optimize the prompt. Values range [True, False], with True being the default. output_directory (str, optional): The directory to save the image to. Returns: Text content with the path to the output image file.

服务配置

[{'mcpServers': {'MiniMax': {'args': ['minimax-mcp'], 'command': 'uvx', 'env': {'MINIMAX_API_HOST': 'https://api.minimaxi.chat', 'MINIMAX_API_KEY': '<insert-your-api-key-here>', 'MINIMAX_MCP_BASE_PATH': '<local-output-dir-path>'}}}}]

来源

• 来源：github
• 链接：https://github.com/MiniMax-AI/MiniMax-MCP