使用说明
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客户端快速入门
- 从获取API密钥 极大极小.
- 安装
uv(Python包管理器),安装curl -LsSf https://astral.sh/uv/install.sh | sh或查看uv仓库 有关其他安装方法。 - 重要: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。
|站起来|
|:-----|:-----|
|本地运行|可以在本地或云中部署|
|沟通方式 stdout |沟通方式 network |
|输入:支持处理 local files 或有效 URL resources |输入:在云中部署时,建议使用 URL 用于输入|
可用工具
| 工具 | 描述 |
|---|---|
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/1080Pmusic_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):
示例用法
⚠️ 警告:使用这些工具可能会产生成本。