MiniMax MCP Server

官方

与MiniMax强大的文本转语音、图像和视频生成API进行交互。

GitHub
1.5k

文档

export

官方 MiniMax 模型上下文协议 (MCP) 服务器，支持与强大的文本转语音及视频/图像生成 API 进行交互。该服务器允许 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等 MCP 客户端生成语音、克隆声音、生成视频、生成图像等。

💡 推荐：MiniMax CLI (mmx-cli) — 我们的官方命令行工具，提供最新模型及文本、视觉、搜索、音乐翻唱等附加功能。可作为 Claude Code、Cursor、OpenClaw 等工具的 AI 代理技能使用。

文档

MCP 客户端快速入门

  1. 从 MiniMax 获取您的 API 密钥。
  2. 安装 uv（Python 包管理器），使用 curl -LsSf https://astral.sh/uv/install.sh | sh 安装，或查看 uv 仓库 了解其他安装方法。
  3. 重要提示：API 主机和密钥因区域而异，必须匹配；否则，您将遇到 Invalid API key 错误。
区域全球中国大陆
MINIMAX_API_KEY前往 MiniMax Global 获取前往 MiniMax 获取
MINIMAX_API_HOSThttps://api.minimax.iohttps://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。

stdioSSE
本地运行可本地部署或云端部署
通过 stdout 通信通过 network 通信
输入：支持处理 local files 或有效的 URL 资源输入：云端部署时，建议使用 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-Hailuo-02，提供 6秒/10秒 时长和 768P/1080P 分辨率选项
  • music_generation - 使用 music-1.5 模型进行高质量音乐创作

常见问题

1. 无效的 API 密钥

请确保您的 API 密钥和 API 主机在区域上保持一致

区域全球中国大陆
MINIMAX_API_KEY前往 MiniMax Global 获取前往 MiniMax 获取
MINIMAX_API_HOSThttps://api.minimax.iohttps://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. 生成图像