← 返回目录

MiniMax MCP

官方

MiniMax 官方 MCP 服务器，提供文本转语音、图片生成、视频生成等 AI 生成能力。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 158 / 438
Stars: ★ 1.6k 非常热门
传输方式: stdio（本地进程） · SSE
运行环境: Python
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 52 天前
工具数: 8

57FMRS · C

MiniMax MCP 服务器是官方维护的，提供多模态生成能力，配置简单，但需注意 API 密钥区域匹配和潜在费用。

最强项 · 文档质量 14/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

10/20

维护活跃度

13/20

文档质量

14/20

安装易用性

12/20

查看各项评分依据

可靠性 8/20: README 中列出了 8 个工具（text_to_audio、list_voices、voice_clone、generate_video、text_to_image、query_video_generation、music_generation、voice_design），安装与配置说明一致，快乐路径看似合理。但本次审查仅提供 README 与仓库元数据，服务器清单未缓存，也没有提供源码、CI 工作流或已提交的测试来验证所声明工具是否与真实行为一致、初始化与工具列表握手能否顺利完成。由于缺少可执行证据，按静态校准规则保守扣分。
安全与权限 10/20: 凭证通过环境变量（MINIMAX_API_KEY）管理，示例配置使用占位符而非真实令牌，README 明确提示调用工具可能产生费用，并要求 API key 与区域主机匹配，这些是正面发现；提供的证据中未发现恶意代码、凭证窃取、隐蔽外传或写入真实密钥等红线问题。扣分点：缺少源码级的最小权限设计证据，付费/生成类操作没有显式确认步骤，除费用提示外未披露发送到 MiniMax 云端 API 的数据范围与保留策略。
维护活跃度 13/20: 仓库未归档，采用 MIT 许可证，隶属于官方 MiniMax-AI 组织；2025 年 7 月 2 日的发布说明（voice_design、MiniMax-Hailuo-02、music-1.5）表明近期有活跃开发。扣分点：未提供提交频率、issue 响应质量、依赖更新策略或安全响应渠道的证据；41 个 open issues 在缺少 issue 跟踪数据的情况下无法评估，版本管理与治理信息不完整。
文档质量 14/20: README 覆盖较全面：安装（uv/uvx）、认证（API key 获取及全球/大陆区域主机映射）、Claude Desktop 与 Cursor 的客户端配置示例、工具描述表、发布说明、带截图的用法示例、费用提示，以及针对 'invalid api key' 和 'spawn uvx ENOENT' 的 FAQ 排障。扣分点：缺少每个工具的参数 schema 与取值范围、速率限制或错误码说明，模型/工具局限性的披露有限，除 README 外未见分层文档。
安装易用性 12/20: 从准备到建立连接的路径较简洁：获取 API key、安装 uv/uvx，再将示例 JSON 配置加入主流客户端即可；README 还针对常见的 'spawn uvx ENOENT' 提供了绝对路径排查方法。根据静态校准，缺少可验证的 CI/测试时 setup 不能超过 15；本次未提供服务器清单、CI 或测试执行证据，minimax-mcp 包能否通过 uvx 正常安装解析未被验证，且 Windows/网络环境差异可能引入额外步骤，故保守给分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络

适合谁

需要快速集成 AI 语音、图像和视频生成能力的开发者和内容创作者
希望在 MCP 支持的客户端中直接使用 MiniMax API 的用户

不适合谁

不需要 AI 生成功能的用户
无法提供有效 API 密钥的用户
希望离线运行或使用其他模型的用户

所需权限

需要有效的 MiniMax API 密钥
可能产生 API 调用费用
可以读取本地文件或网络 URL 作为输入

风险与副作用

API 密钥错误或区域不匹配可能导致 'invalid api key' 错误
使用这些工具可能产生费用
生成的音频、图片、视频可能受版权和伦理限制

安装接入

准备工作

运行环境：Python

MINIMAX_API_KEY 必填密钥 MiniMax 平台的接口密钥，从 MiniMax Global 或 MiniMax（大陆）平台的用户中心获取，需与 API host 区域匹配。

MINIMAX_MCP_BASE_PATH 必填生成的音频/图片/视频文件的本地输出目录，如 /User/xxx/Desktop。

MINIMAX_API_HOST 必填 API 主机地址，全球站为 https://api.minimax.io，大陆站为 https://api.minimaxi.com，必须与密钥区域一致。

其他可选配置项（1 个）

MINIMAX_API_RESOURCE_MODE 可选可选，取值 url 或 local（默认 url），决定音频/图片/视频以 URL 还是本地文件形式返回。

从 MiniMax 官网获取 API 密钥（注意区分国际站和中国大陆站）。
安装 uv（Python 包管理器）。
配置 MCP 客户端（如 Claude Desktop）的 claude_desktop_config.json 文件，添加 MiniMax 服务器配置。

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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "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"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add MiniMax -e MINIMAX_API_KEY=insert-your-api-key-here -e 'MINIMAX_MCP_BASE_PATH=local-output-dir-path, such as /User/xxx/Desktop' -e 'MINIMAX_API_HOST=api host, https://api.minimax.io | https://api.minimaxi.com' -e 'MINIMAX_API_RESOURCE_MODE=optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format' -- uvx minimax-mcp -y

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端工具列表中确认出现 text_to_audio、generate_video 等 8 个工具，然后尝试执行 list_voices，若能返回语音列表即说明连接成功。

常见排障

检查 API 密钥与主机是否区域匹配（国际站 use api.minimax.io，大陆站 use api.minimaxi.com）
如果出现 'spawn uvx ENOENT'，请确认 uvx 的绝对路径并更新配置
异步视频生成时需定义完成规则

试试这样问

连接成功后，可以直接对 AI 助手这样说：

把这段新闻播报文字转成语音
列出所有可用的语音
用我的录音克隆一个声音
根据提示词生成一段视频

工具能力 8

text_to_audio 写入

将文本转换为指定语音的音频。

list_voices 只读

列出所有可用的语音。

voice_clone 写入

使用提供的音频文件克隆语音。

generate_video 写入

根据提示生成视频。

text_to_image 写入

根据提示生成图片。

query_video_generation 只读

查询视频生成任务的结果。

music_generation 写入

根据提示和歌词生成音乐曲目。

voice_design 写入

根据提示和预览文本生成自定义语音。

使用场景

广播新闻片段

克隆语音

生成视频

生成图片

支持客户端

Claude Desktop

Cursor

Windsurf

OpenAI Agents

依据项目文档列出，未经本站实测。

详细介绍

MiniMax MCP 服务器是 MiniMax 官方的 Model Context Protocol (MCP) 实现，允许 MCP 客户端（如 Claude Desktop、Cursor、Windsurf、OpenAI Agents）通过标准接口调用 MiniMax 的 AI 生成 API。该服务器支持文本转语音、语音克隆、文本转图片、文本转视频（含异步查询）、音乐生成和语音设计等功能。