/ 目录 / 演练场 / MiniMax-MCP
● 社区 MiniMax-AI ⚡ 即开即用

MiniMax-MCP

作者 MiniMax-AI · MiniMax-AI/MiniMax-MCP

MiniMax 官方 MCP——文字转语音、声音克隆、文字转图像、文字转视频和音乐生成,全部在聊天中完成。

MiniMax-AI/MiniMax-MCP 是 MiniMax 官方 MCP,封装了他们的 TTS、声音设计、图像、视频和音乐 API。区域特定:全球版(api.minimax.io)和大陆版(api.minimaxi.com)需要分别的 API 密钥。

为什么要用

核心特性

实时演示

实际使用效果

minimax.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "minimax": {
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "minimax",
      "command": "uvx",
      "args": [
        "MiniMax-MCP"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "minimax": {
      "command": {
        "path": "uvx",
        "args": [
          "MiniMax-MCP"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add minimax -- uvx MiniMax-MCP

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: MiniMax-MCP

如何将博文转化为旁白音频

👤 创作者、播客主持人、无障碍团队 ⏱ ~15 min beginner

何时使用: 当你想要文字内容的可听版本时。

前置条件
  • MiniMax 账户 + API 密钥 — 全球版:minimax.io;大陆版:minimaxi.com。设置 MINIMAX_API_KEY + MINIMAX_API_HOST 匹配对应区域
  • 已安装 uvx — brew install uv
步骤
  1. 列出声音
    list_voices——展示所有可用的英文声音。✓ 已复制
    → 包含预览的声音目录
  2. 生成音频
    text_to_audio:[粘贴文章] 使用声音 'female-calm-en'。保存到 /audio/article.mp3。✓ 已复制
    → MP3 文件已保存,返回 URL

结果: 你的内容的可听音频版本。

注意事项
  • 长文章会触及单次调用的字符限制 — 分段渲染后拼接
  • 专有名词的发音不准确 — 使用 SSML 风格的音标提示或 voice_design 工具生成专门的声音
搭配使用: filesystem

如何克隆你的声音用于旁白

👤 希望有一致旁白的创作者 ⏱ ~10 min intermediate

何时使用: 当你想要用自己的声音进行 AI 旁白时。

前置条件
  • 10-60 秒的声音样本(干净的音频,你的声音) — 通过手机录音;导出为 mp3/wav
步骤
  1. 克隆
    voice_clone 使用样本 /recordings/me.wav,名称为 'my-voice'。✓ 已复制
    → 返回声音 ID
  2. 使用它
    text_to_audio 使用 voice='my-voice' 对 [粘贴文本] 处理。✓ 已复制
    → 以你的声音输出

结果: 无需每次都拿麦克风进行个人旁白。

注意事项
  • 未经许可使用他人的声音 — 不要这样做——这是法律和道德问题;改用 voice_design

如何生成图像并将其转化为短视频

👤 内容创作者、营销人员 ⏱ ~15 min intermediate

何时使用: 社交内容、产品预览。

步骤
  1. 生成图像
    text_to_image:'陶瓷杯的极简工作室产品照,自然光'。✓ 已复制
    → 图像 URL
  2. 制作动画
    generate_video 提示词为 'slow rotating mug on a wooden table'。使用 query_video_generation 轮询状态。✓ 已复制
    → 准备好时返回视频 URL

结果: 短的营销视频。

注意事项
  • 视频生成是异步的,可能需要几分钟 — 始终使用 query_video_generation 轮询——不要让聊天阻塞等待
搭配使用: google-workspace

组合

与其他 MCP 搭配,撬动十倍杠杆

minimax + filesystem

将生成的资产保存到结构化内容文件夹

为 /manuscript/ 中的每一章生成旁白,并将 MP3 保存到 /audio/chapters/。✓ 已复制

从 Google Doc 生成音频,然后在文档中附加链接

读取 Doc 'Launch Post',生成旁白,上传到 Drive,在页脚添加链接。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
text_to_audio text: str, voice: str, format?: 'mp3'|'wav', output_path? 将文本转化为旁白 Per MiniMax TTS pricing
list_voices language?: str 查找声音 free
voice_clone sample_path: str, name: str 自定义声音 Per MiniMax pricing
voice_design description: str 从文本描述生成声音 Per MiniMax pricing
text_to_image prompt: str, aspect_ratio? 图像生成 Per MiniMax image pricing
generate_video prompt: str, duration_s? 启动视频生成 Per MiniMax video pricing
query_video_generation task_id 轮询视频任务 free
music_generation lyrics: str, genre?: str 创建短音轨 Per MiniMax music pricing

成本与限制

运行它的成本

API 配额
按 MiniMax 方案而定——在 minimax.io 或 minimaxi.com 查看当前定价
每次调用 Token 数
适度的文本输入;输出为音频/图像/视频文件
费用
按次付费;最便宜的方式是从 Flash/Hailuo-Mini 等同产品开始
提示
尽可能将短 TTS 合并为较少的较长调用;视频最贵——缓存结果。

安全

权限、密钥、影响范围

最小权限: MINIMAX_API_KEY + MINIMAX_API_HOST 匹配到区域
凭据存储: 环境变量
数据出站: 你的文本/音频会发送到所选区域的 MiniMax 服务器
切勿授予: 不要混合全球和大陆密钥——会导致 'Invalid API key'

故障排查

常见错误与修复

无效的 API 密钥

密钥和主机区域必须匹配。全球版设置 MINIMAX_API_HOST=https://api.minimax.io,大陆版设置 https://api.minimaxi.com。

验证: env | grep MINIMAX
视频生成永不完成

使用 query_video_generation 轮询最多 10 分钟;超过预期通常表示服务器负载。如果卡住,用新任务重试。

voice_clone 质量差

样本音频必须是 10-60 秒,干净(无音乐/噪音),单一说话者。

超过速率限制

MiniMax 强制执行每分钟和每天上限。退避;升级方案以获得更高限制。

替代方案

MiniMax-MCP 对比其他方案

替代方案何时用它替代权衡
ElevenLabs MCP当你想要专注西方市场的 TTS,具有专用英文声音时一个捆绑包中没有视频/图像/音乐
OpenAI/Whisper for TTS当你已经有 OpenAI 额度时声音选项比 MiniMax 少

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills