Mini Max MCP

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech and video/image generation APIs. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, generate video, generate image and more.

文档

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

MCP客户端快速入门

1. 从获取API密钥 极大极小.
2. 安装 uv （Python包管理器），安装 curl -LsSf https://astral.sh/uv/install.sh | sh 或查看 uv 仓库 有关其他安装方法。
3. 重要：API主机和密钥因地区而异，必须匹配；否则，你会遇到 Invalid API key 错误。

|地区|全球|大陆| |:--|:-----|:-----| |MINIMAX_API_KEY |从获取 MiniMax全球 |去吧 极大极小 | |最小值_API_HOST |https://api.minimax.io | https://api.minimaxi.com |

克劳德桌面版

首选 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错误：API密钥无效”，请检查您的API主机：

• 全球主机：https://api.minimax.io
• 大陆主办单位：https://api.minimaxi.com

如果您使用的是Windows，则必须在Claude Desktop中启用“开发人员模式”才能使用MCP服务器。单击左上角汉堡包菜单中的“帮助”，然后选择“启用开发人员模式”。

光标

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

就是这样。您的MCP客户端现在可以通过以下工具与MiniMax交互：

运输

我们支持两种传输类型：stdio和sse。

可用工具

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

发布说明

2025年7月2日

🆕 新增功能

• 语音设计新 voice_design 工具-根据带有预览音频的描述性提示创建自定义语音
• 视频增强：已添加 MiniMax-Hailuo-02 具有超清晰质量和持续时间/分辨率控制的模型
• 音乐发生器：增强 music_generation 工具由 music-1.5 模型

📈 增强工具

• voice_design -根据文本描述生成个性化语音
• generate_video -现在支持MiniMax-Haileuo-02，持续时间为6s/10s，分辨率为768P/1080P
• music_generation -音乐-1.5模型的高品质音乐创作

常见问题解答

1.无效的api密钥

请确保您的API密钥和API主机区域一致 |地区|全球|大陆| |:--|:-----|:-----| |MINIMAX_API_KEY |从获取 MiniMax全球 |去吧 极大极小 | |最小值_API_HOST |https://api.minimax.io | https://api.minimaxi.com |

2.产卵

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

which uvx

获得绝对路径（例如/usr/local/bin/uvx）后，更新配置以使用该路径（例如“command”：“/usr/local/bin/uvx”）。

3.如何使用 generate_video 在异步模式下

开始前定义完成规则：

或者，可以在IDE设置中配置这些规则（例如Cursor）：

示例用法

⚠️ 警告：使用这些工具可能会产生成本。

1.播放一段晚间新闻

2.克隆声音

3.生成视频

4.生成图像