MiniMax官方模型上下文协议(MCP)服务器,支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude Desktop、Cursor、Windsurf、OpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。
uv
(Python包管理器),使用curl -LsSf https://astral.sh/uv/install.sh | sh
安装或查看uv
仓库获取其他安装方法。invalid api key
的错误地区 | 国际 | 国内 |
---|---|---|
MINIMAX_API_KEY | 获取密钥 MiniMax国际版 | 获取密钥 MiniMax |
MINIMAX_API_HOST | https://api.minimaxi.chat (请注意额外的 "i" 字母) | https://api.minimax.chat |
前往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.minimax.chat 或 https://api.minimaxi.chat", "MINIMAX_API_RESOURCE_MODE": "可选配置,资源生成后的提供方式, 可选项为 [url|local], 默认为 url" } } } }
⚠️ 注意:API Key需要与Host匹配。如果出现“API Error: invalid api key”错误,请检查您的API Host:
https://api.minimaxi.chat
(请注意额外的 "i" 字母)https://api.minimax.chat
如果你使用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 生成图片 |
请检查你获取的 API Key 和填写的 API Host 是否是同一地区的:
地区 | 国际 | 国内 |
---|---|---|
MINIMAX_API_KEY | 获取密钥 MiniMax国际版 | 获取密钥 MiniMax |
MINIMAX_API_HOST | https://api.minimaxi.chat (请注意额外的 "i" 字母) | https://api.minimax.chat |
请在你的终端输入一下命令,查看uvx命令的绝对路径:
which uvx

如果得到如下的输出 (如:/usr/local/bin/uvx),更新mcp配置 ("command": "/usr/local/bin/uvx").
⚠️ 注意:使用这些工具可能会产生费用。