MiniMax MCP

MiniMax 官方 Model Context Protocol（MCP）服务，可与强大的文本转语音及视频/图像生成 API 交互。该服务允许 MCP 客户端（例如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等）生成语音、克隆声音、生成视频和图像，以及执行更多操作。

💡 推荐使用：MiniMax CLI (mmx-cli) — 我们的官方命令行工具，提供最新模型和文本、视觉及搜索等更多功能。可作为 AI Agent 技能用于 Claude Code、Cursor、OpenClaw 等。

文档

• 中文文档
• 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 主机和密钥因地区而异，必须匹配；否则会遇到 Invalid API key 错误。

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

Claude Desktop

前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json，加入以下内容：

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

⚠️ 警告：API 密钥必须与主机匹配。如果出现错误“API Error: invalid api key”，请检查 API 主机：

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

如果使用 Windows，必须在 Claude Desktop 中启用“Developer Mode”才能使用 MCP 服务。点击左上角汉堡菜单中的“Help”，然后选择“Enable Developer Mode”。

Cursor

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

完成后，MCP 客户端即可通过这些工具与 MiniMax 交互：

传输方式

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

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

可用工具

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

发行说明

2025 年 7 月 2 日

🆕 新功能

• 声音设计：新增 voice_design 工具，可根据描述性提示词创建自定义声音并生成预览音频
• 视频增强：新增 MiniMax-Hailuo-02 模型，支持超清画质以及时长/分辨率控制

📈 工具增强

• voice_design - 根据文本描述生成个性化声音
• generate_video - 现已支持 MiniMax-Hailuo-02，可选择 6s/10s 时长和 768P/1080P 分辨率

常见问题

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. 生成图像