MiniMax MCP
官方与MiniMax强大的文本转语音、图像及视频生成API进行交互。
你可以用 MiniMax MCP 做什么?
- 文本转语音 — 让助手使用指定的声音将书面文本转换为音频。
- 声音克隆 — 根据你提供的音频文件克隆声音,然后将其用于语音生成。
- 声音设计 — 根据描述性提示生成自定义声音,并提供预览音频。
- 图像生成与编辑 — 根据提示创建 1K/2K/4K 像素面积的图像,或使用提示和最多 16 张参考图像编辑图像。
- 视频生成 — 根据提示生成视频,可选择时长和分辨率,之后还可查询任务结果。
文档

MiniMax 官方 Model Context Protocol (MCP) 服务器,可与强大的文本转语音及视频/图像生成 API 交互。此服务器允许 MCP 客户端(如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等)生成语音、克隆声音、生成视频和图像等。
💡 推荐:MiniMax CLI (mmx-cli) — 我们的官方命令行工具,提供最新模型及文本、视觉和搜索等更多功能。可作为 Claude Code、Cursor、OpenClaw 等工具的 AI 代理技能使用。
文档
- 中文文档
- MiniMax-MCP-JS - MiniMax MCP 的官方 JavaScript 实现
使用 MCP 客户端快速入门
- 从 MiniMax 获取 API 密钥。
- 安装
uv(Python 包管理器),使用curl -LsSf https://astral.sh/uv/install.sh | sh安装,或查看uv仓库了解其他安装方式。 - 重要: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 中启用“开发者模式”才能使用 MCP 服务器。点击左上角汉堡菜单中的“帮助”,然后选择“启用开发者模式”。
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 | 根据提示生成图像。默认使用 MiniMax-H3-Image(支持 area 1K/2K/4K 和 size);仍可通过 model 使用 image-01 |
image_edit | 使用提示和 1-16 张参考图像,通过 MiniMax-H3-Image 编辑图像 |
query_video_generation | 查询视频生成任务的结果 |
voice_design | 根据提示和预览文本生成声音 |
发行说明
2026 年 11 月 10 日
🆕 新增内容
- 图像编辑:新增
image_edit工具 — 使用提示和 1-16 张参考图像(URL、数据 URI、mm_file://或本地路径),通过 MiniMax-H3-Image 编辑图像 - H3 图像生成:
text_to_image现在默认使用 MiniMax-H3-Image,并支持area(1K/2K/4K)和size;仍可通过model参数使用image-01
📈 工具增强
text_to_image- 默认使用 MiniMax-H3-Image(/v1/images/generations);传入model="image-01"可使用之前的模型
2025 年 7 月 2 日
🆕 新增内容
- 声音设计:新增
voice_design工具 - 根据描述性提示创建自定义声音,并生成预览音频 - 视频增强:新增
MiniMax-Hailuo-02模型,提供超清画质以及时长/分辨率控制
📈 工具增强
voice_design- 根据文本描述生成个性化声音generate_video- 现已支持 MiniMax-Hailuo-02,可选择 6 秒/10 秒时长和 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. 生成图像
