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

文档

• 中文文档
• MiniMax-MCP-JS - MiniMax MCP 的官方 JavaScript 实现

使用 MCP 客户端快速入门

1. 从 MiniMax 获取您的 API 密钥。
2. 安装 uv（Python 包管理器），可通过 curl -LsSf https://astral.sh/uv/install.sh | sh 命令安装，或参阅 uv 的 仓库 以获取其他安装方法。
3. 重要提示：API 主机和密钥因地区而异，必须匹配；否则，您将收到“无效的 API 密钥”错误。

地区	全球	中国大陆
MINIMAX_API_KEY	从 MiniMax 全球 获取	从 MiniMax 获取
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

Claude Desktop

前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json，添加以下内容：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "在此处插入您的API密钥",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，例如 /User/xxx/Desktop",
        "MINIMAX_API_HOST": "API主机地址，https://api.minimax.io 或 https://api.minimaxi.com",
        "MINIMAX_API_RESOURCE_MODE": "可选，[url|local]，默认为url，音频/图片/视频可以下载到本地或以URL形式提供"
      }
    }
  }
}

⚠️ 注意：API密钥必须与主机匹配。如果出现“API错误：无效的API密钥”提示，请检查您的API主机：

• 全球主机：https://api.minimax.io
• 中国大陆主机：https://api.minimaxi.com

如果您使用的是Windows系统，需要在Claude Desktop中启用“开发者模式”才能使用MCP服务器。请单击左上角汉堡菜单中的“帮助”，然后选择“启用开发者模式”。

Cursor

前往 Cursor -> 首选项 -> Cursor设置 -> MCP -> 添加新的全局MCP服务器，添加上述配置。

完成以上步骤后，您的MCP客户端即可通过这些工具与MiniMax进行交互：

传输方式

我们支持两种传输方式：stdio 和 sse。

stdio	SSE
在本地运行	可以部署在本地或云端
通过 stdout 进行通信	通过 网络 进行通信
输入：支持处理 本地文件 或有效的 URL 资源	输入：在云端部署时，建议使用 URL 作为输入

可用工具

工具	描述
text_to_audio	将文本转换为指定语音的音频
list_voices	列出所有可用的语音
voice_clone	使用提供的音频文件克隆语音
generate_video	根据提示生成视频
text_to_image	根据提示生成图像
query_video_generation	查询视频生成任务的结果
music_generation	根据提示和歌词生成音乐曲目
voice_design	使用预览文本根据提示生成语音

发布说明

2025年7月2日

🆕 新功能

• Voice Design：新增 voice_design 工具——通过描述性提示和预览音频创建自定义语音
• 视频增强：新增 MiniMax-Hailuo-02 模型，具有超清晰画质，并可控制时长和分辨率
• 音乐生成：由 music-1.5 模型驱动的 music_generation 工具得到增强

📈 功能提升

• voice_design——根据文本描述生成个性化语音
• generate_video——现支持 MiniMax-Hailuo-02 模型，提供6秒/10秒时长及768P/1080P分辨率选项
• music_generation——基于 music-1.5 模型实现高质量音乐创作

常见问题解答

1. API密钥无效

请确保您的API密钥和API主机在地域上一致：

地区	全球	中国大陆
MINIMAX_API_KEY	从 MiniMax Global 获取	从 MiniMax 获取
MINIMAX_API_HOST	https://api.minimax.io	https://api.minimaxi.com

2. spawn uvx ENOENT

请通过在终端中运行以下命令确认其绝对路径：

which uvx

获取绝对路径后（例如 /usr/local/bin/uvx），请更新您的配置以使用该路径（例如 "command": "/usr/local/bin/uvx"）。

3. 如何以异步模式使用 generate_video

在开始之前定义完成规则： 或者，您也可以在IDE设置中配置这些规则（例如 Cursor）：

使用示例

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

1. 播报一段晚间新闻

2. 克隆一种语音

3. 生成一段视频

4. 生成图像

MiniMax-MCP 快速上手指南

MiniMax-MCP 是官方的模型上下文协议（MCP）服务器，允许 Claude Desktop、Cursor、Windsurf 等客户端调用 MiniMax 强大的语音合成、声音克隆、视频生成及图像生成能力。

环境准备

在开始之前，请确保满足以下要求：

1. API 密钥：拥有有效的 MiniMax API Key。
   • 中国大陆用户：请访问 MiniMax 开放平台 获取密钥。
   • 海外用户：请访问 MiniMax Global 获取密钥。
2. Python 包管理器 uv：本项目依赖 uv 运行。
   • 安装命令（Linux/macOS）：

     curl -LsSf https://astral.sh/uv/install.sh | sh
     

   • Windows 用户请参考 uv 官方仓库 进行安装。
3. 支持的 MCP 客户端：已安装 Claude Desktop、Cursor 或 Windsurf 等支持 MCP 协议的编辑器/应用。

⚠️ 重要提示：API Key 必须与 API 主机地址（Host）区域对应，否则会报错 Invalid API key。

• 中国大陆：Key 来自 platform.minimaxi.com，Host 设为 https://api.minimaxi.com
• 全球其他地区：Key 来自 www.minimax.io，Host 设为 https://api.minimax.io

安装与配置

根据你使用的客户端，选择以下一种方式进行配置。

方式一：Claude Desktop 配置

1. 打开配置文件：Claude > Settings > Developer > Edit Config，编辑 claude_desktop_config.json。
   • Windows 用户注意：需先在左上角菜单 Help 中启用 "Enable Developer Mode"。
2. 将以下配置填入 JSON 文件中（注意替换占位符）：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "在此处填入你的 API Key",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，例如 C:/Users/xxx/Desktop 或 /Users/xxx/Desktop",
        "MINIMAX_API_HOST": "API 主机地址 (国内: https://api.minimaxi.com | 国际: https://api.minimax.io)",
        "MINIMAX_API_RESOURCE_MODE": "可选，[url|local]。默认为 url，设为 local 则音频/图片/视频下载到本地"
      }
    }
  }
}

方式二：Cursor 配置

1. 打开设置：Cursor -> Preferences -> Cursor Settings -> MCP。
2. 点击 Add new global MCP Server。
3. 填入与上述 Claude Desktop 相同的配置内容（Command, Args, Env 变量）。

基本使用

配置完成后，重启你的 MCP 客户端（如 Claude Desktop 或 Cursor），即可在对话框中直接通过自然语言调用以下工具：

可用工具列表

工具名称	功能描述
text_to_audio	文本转语音（TTS）
list_voices	列出所有可用音色
voice_clone	使用音频文件克隆声音
generate_video	根据提示词生成视频
text_to_image	根据提示词生成图片
music_generation	根据提示词和歌词生成音乐
voice_design	根据描述生成定制音色

使用示例

在聊天窗口中直接输入指令即可，无需编写代码：

示例 1：生成语音

“请用温柔的女声把这段文字读出来：‘欢迎使用 MiniMax MCP 工具。’"

示例 2：生成视频

“生成一个视频，画面是一只猫在夕阳下的草地上奔跑，时长 6 秒。”

示例 3：声音克隆

“我想克隆这个音频文件里的声音（上传音频文件），然后用它朗读这段新闻稿。”

示例 4：生成图片

“画一张赛博朋克风格的城市夜景图，分辨率要高。”

客户端会自动调用后台的 minimax-mcp 服务，处理完成后会将生成的音频、视频或图片直接展示在对话中或保存到指定的 MINIMAX_MCP_BASE_PATH 目录。