MiniMax官方模型上下文协议(MCP)服务器，支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude Desktop、Cursor、Windsurf、OpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。
- English Documentation
- MiniMax-MCP-JS - MiniMax MCP的官方JavaScript版本
- 从MiniMax国内开放平台｜MiniMax国际开放平台获取你的 API 密钥。
- 安装
uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv仓库获取其他安装方法。 - 重要提示: API的服务器地址和密钥在不同区域有所不同，两者需要匹配，否则会有
invalid api key的错误
| 地区 | 国际 | 国内 |
|---|---|---|
| MINIMAX_API_KEY | 获取密钥 MiniMax国际版 | 获取密钥 MiniMax |
| 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"
],
"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"
}
}
}
}
- 国际版Host：
https://api.minimax.io - 国内版Host：
https://api.minimaxi.com
如果你使用Windows，你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help"，然后选择"Enable Developer Mode"。
前往Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server添加上述配置。
你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互：
我们支持两种传输方式: stdio and sse.
| stdio | SSE |
|---|---|
| 在本地部署运行 | 本地或云端部署均可 |
| 通过 stdout 进行通信 | 通过网络通信 |
| 输入：支持处理本地文件，或有效的URL资源 | 输入: 若部署在云端，建议使用URL进行输入 |
| 方法 | 描述 |
|---|---|
text_to_audio |
使用指定音色将文本生成音频 |
list_voices |
查询所有可用音色 |
voice_clone |
根据指定音频文件克隆音色 |
generate_video |
根据指定 prompt 生成视频 |
text_to_image |
根据指定 prompt 生成图片 |
music_generation |
根据指定 prompt 和歌词生成音乐 |
voice_design |
根据指定 prompt 生成音色和试听文本 |
- 音色设计: 新增
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 模型进行高质量音乐创作
请检查你获取的 API Key 和填写的 API Host 是否是同一地区的：
| 地区 | 国际 | 国内 |
|---|---|---|
| MINIMAX_API_KEY | 获取密钥 MiniMax国际版 | 获取密钥 MiniMax |
| MINIMAX_API_HOST | https://api.minimax.io | https://api.minimaxi.com |
请在你的终端输入一下命令，查看uvx命令的绝对路径：
which uvx如果得到如下的输出 (如：/usr/local/bin/uvx)，更新mcp配置 ("command": "/usr/local/bin/uvx").
在对话前设置一些规则:
