模型上下文协议(MCP)简介
模型上下文协议(MCP) 是一个开放协议,标准化应用程序向大语言模型提供工具和上下文的方式。它类似于 AI 领域的 USB‑C 接口,提供一个稳定和标准化的接入点,让模型能访问数据库、API、插件或其他工具。通过 MCP 工具,开发者可以让模型访问托管在远程 MCP 服务器上的各种工具。 MiniMax 提供官方的 Python 版本和 JavaScript 版本 模型上下文协议(MCP)、声音克隆、图像生成、视频生成等多模态能力。 开发者可自行部署 MCP 服务,并通过 MCP 客户端(如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等)调用,从而快速集成语音、图像和视频相关功能。在传输方面,Python 版本提供 stdio 和 SSE 两种标准传输方式,JS 版本提供 stdio 、REST 和 SSE 三种标准传输方式。MiniMax MCP 工具和参数介绍
MCP 工具清单
text_to_audio
该工具可将将输入的文本合成为自然流畅的语音
list_voices
该工具可查询所有可用音色
voice_clone
该工具可根据指定音频文件克隆音色
voice_design
该工具可根据指定提示词生成音色和试听文本
play_audio
该工具用于播放一个音频文件
music_generation
该工具可根据指定提示词和歌词生成音乐
generate_video
该工具可根据指定文本或图片进行视频生成生成
image_to_video
该工具用于使用首帧图像生成视频
query_video_generation
该工具用于查询异步视频生成任务的状态
text_to_image
该工具可根据指定提示词生成图片
工具与参数详情
1. text_to_audio
该工具可将输入的文本合成为自然流畅的语音。参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
text | 必需,待合成的文本 | 字符串,长度限制 < 10000 字符,段落切换用换行符替代。 | 无 |
output_directory | 保存音频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
voice_id | 请求的音色编号 | 字符串,可选值可参考 API 手册 | "female-shaonv" |
model | 请求的模型版本 | 字符串,可选值可参考 API 手册 | "speech-02-hd" |
speed | 生成音频的语速 | 浮点数,范围 [0.5 - 2.0] | 1.0 |
vol | 生成音频的音量 | 浮点数,范围 | 1.0 |
pitch | 生成音频的音调 | 整数,范围 [-12,12] | 0 (原音色输出) |
emotion | 控制合成语音的情绪 | 字符串,可选值范围["happy", "sad", "angry", "fearful", "disgusted", "surprised", "calm"] ,该参数仅对 speech-02-hd, speech-02-turbo, speech-01-turbo, speech-01-hd 模型生效 | happy |
sample_rate | 生成音频的采样率 | 整数,可选范围 [8000, 16000, 22050, 24000, 32000, 44100] | 32000 |
bitrate | 生成音频的比特率 | 整数,可选范围 [32000, 64000, 128000, 256000] ,该参数仅对 mp3 格式的音频生效 | 128000 |
channel | 生成音频的声道数 | 整数,可选值为 1:单声道, 2:双声道 | 1 |
format | 生成的音频文件格式 | 字符串,可选范围["pcm", "mp3", "flac", "wav"] ,其中,“wav” 仅在非流式传输下支持 | mp3 |
language_boost | 语言增强选项,提升在指定小语种或方言场景下的语音表现 | 字符串,可选值可参考 API 手册 | null |
2. list_voices
该工具可查询所有可用音色参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
voice_type | 需要查询的音色类型。 | 字符串, 可选值范围 [“system” (系统音色) , “voice_cloning” (快速复刻的音色) , “voice_generation” (文生音色接口生成的音色) , “music_generation” (音乐生成产生的人声或者伴奏音色) , “all” (以上全部) ] | “all” |
3. voice_clone
该工具可根据指定音频文件克隆音色参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
voice_id | 必需, 音色复刻的声音编号 | 字符串, 可自定义, 注意事项包括 1. 自定义的 voice_id 长度范围 2. 首字符必须为英文字母 3. 允许数字、字母、-、_4. 末位字符不可为-、_5. 创建的 voice_id 不可与之前重复 | 无 |
file | 必需, 用于克隆的音频文件 | 字符串, 可选范围[“mp3”, “m4a”, “wav”] | 无 |
text | 生成克隆音色演示音频的文本 | 字符串, 限制 2000 字符以内 | 无 |
output_directory | 保存音频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
is_url | 用于克隆的音频文件来源是否 url | 布尔值 (True / False) | FALSE |
4. voice_design
该工具可根据指定提示词生成音色和试听文本参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
prompt | 必需, 生成音色的描述 | 字符串 | 无 |
preview_text | 必需, 生成试听音频的文本 | 字符串 | 无 |
voice_id | 自定义生成音色的 ID | 字符串 | 自动生成唯一值 |
output_directory | 保存试听音频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
5. play_audio
该工具用于播放一个音频文件。参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
input_file_path | 必需, 要播放的音频文件的本地路径或 URL | 字符串 (文件路径或 URL) | 无 |
is_url | 需要播放的音频文件来源是否 url | 布尔值 (True / False) | FALSE |
6. music_generation
该工具可根据指定提示词和歌词生成音乐参数 | 含义 | 可选值/格式 | 默认值 |
---|---|---|---|
prompt | 必需, 表示音乐创作的灵感,通常是对音乐风格、情绪、场景等的描述 | 字符串, 字符取值范围 [10-300] | 无 |
lyrics | 必需, 音乐生成的歌词 | 字符串, 使用换行符 (\n ) 分隔每行歌词, 支持结构标签 [Intro][Verse][Chorus][Bridge][Outro], 字符取值范围 | 无 |
sample_rate | 生成音乐的采样率 | 整数, 可选值范围 | 32000 |
bitrate | 生成音乐的比特率 | 整数, 可选值范围 | 128000 |
format | 生成音乐的格式 | 字符串, 可选值范围 [“mp3”, “wav”, “pcm”] | “mp3” |
output_directory | 保存音乐文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
7. generate_video
该工具可根据指定提示词生成视频,prompt
和 first_frame_image
两个参数至少要有一个。
参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
prompt | 生成视频的描述 | 字符串, 最大支持 2000 字符 | 无 |
model | 请求的模型版本 | 字符串, 可选范围 MiniMax-Hailuo-02 , T2V-01-Director , I2V-01-Director , S2V-01 , I2V-01-live , I2V-01 , T2V-01 | T2V-01 |
first_frame_image | 视频的首帧画面 | 支持传入图片的 “data:image/jpeg;base64,data” 格式的 Base64 编码字符串, 或可通过公网访问的 URL | 无 |
duration | 生成视频的持续时间 (秒) | 整数, 可选值, 与分辨率和模型相关: 01 系列 (包括 T2V-01, I2V-01,T2V-01-Director, I2V-01-Director, I2V-01-live, S2V-01): 可选值: 6 02 系列 (MiniMax-Hailuo-02) : 512P: 可选值: 6, 10 768P: 可选值: 6, 10 1080P: 可选值: 6 | 6 |
resolution | 生成视频的分辨率 | 字符串, 与选择模型及设置的视频时长相关: 01 系列 (包括 T2V-01, I2V-01,T2V-01-Director, I2V-01-Director, I2V-01-live, S2V-01): 不支持设置本参数。 02 系列 6s 时长: 默认值为”720P”, 可选范围 ["512P", "768P", "1080P"] 10s 时长: 默认值”768P”, 可选范围 ["512P", "768P"] | None |
output_directory | 保存视频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
async_mode | 是否使用异步模式, 启用则返回任务 ID | 布尔值 (True / False) | FALSE |
8. image_to_video
该工具用于使用首帧图像生成视频, 其中prompt
和 first_frame_image
两个参数至少有其一, 该 MCP 工具仅在 JavaScript/TypeScript 版本中可用
参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
prompt | 必需, 生成视频的描述。 | 字符串, 最大支持 2000 字符 | 无 |
model | 请求的模型版本 | 字符串, 可选范围 [“MiniMax-Hailuo-02”, “T2V-01-Director”, “I2V-01-Director”, “S2V-01”, “I2V-01-live”, “I2V-01”, “T2V-01”] | “T2V-01” |
first_frame_image | 必需, 视频的首帧画面 | 支持传入图片的 “data:image/jpeg;base64,data” 格式的 Base64 编码字符串, 或可通过公网访问的 URL | 无 |
output_directory | 保存视频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
async_mode | 是否使用异步模式, 启用则返回任务 ID | 布尔值 (True / False) | FALSE |
9. query_video_generation
该工具用于查询异步视频生成任务的状态。参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
task_id | 必需, 需要查询的任务 ID | 字符串 | 无 |
output_directory | 保存视频文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
10. text_to_image
该工具可根据指定提示词生成图片参数 | 含义 | 格式及说明 | 默认值 |
---|---|---|---|
prompt | 必需, 生成图像的描述 | 字符串, 最大支持 1500 字符 | 无 |
model | 请求的模型版本 | 字符串, 可选范围 [“image-01”, “image-01-live”] | “image-01” |
aspect_ratio | 生成图像的宽高比 | 字符串, 可选范围 [“1:1”, “16:9”, “4:3”, “3:2”, “2:3”, “3:4”, “9:16”, “21:9”] | “1:1” |
n | 单次请求生成的图片数量 | 整数, 可选范围 | 1 |
prompt_optimizer | 是否开启提示词自动优化提示词 | 布尔值 (True / False) | TRUE |
output_directory | 保存图片文件的目录 | 字符串 (文件路径) | 配置文件中设置的路径 |
在客户端使用 MiniMax MCP 服务
获取 API Key
- 访问 MiniMax 开放平台
- 点击“Create new secret key”按钮,输入项目名称以创建新的 API Key。
- 创建成功后,系统将展示 API Key。请务必复制并妥善保存,该密钥只会显示一次,无法再次查看。

UVX 安装和配置
MiniMax‑MCP 是一个 Python 实现的 MCP 服务,为了让 MCP 客户端顺利调用,该服务必须通过uvx
启动和执行。 uvx
和 uv
提供的命令行工具,类似于 npm exec
,用于运行包内部定义的可执行程序,确保环境隔离与依赖可控。
- 安装
uv
以便获取uvx
- macOS / Linux 用户:
- Windows 用户:
Scripts
或 bin
目录中生成 uv
和 uvx
可执行文件。
- 验证
uvx
是否可用
- macOS / Linux 用户:
- Windows 用户:
- 若正确安装,会显示路径(如
/usr/local/bin/uvx
)。 - 若系统报错
spawn uvx ENOENT
,说明没有安装uvx
或uvx
不在系统路径中,需要配置绝对路径。
传输方式说明
MiniMax-MCP 提供 studio 和 SSE 两种传输方式,在使用时可按需选择特性 | stdio(默认) | SSE(Server‑Sent Events) |
---|---|---|
运行环境 | 本地部署运行 | 本地部署或云端部署均可 |
通信方式 | 通过 stdout 进行通信 | 通过网络通信 |
适用场景 | 本地 MCP 客户端集成 | 需要服务器推送的应用 |
输入资源支持 | 支持本地文件或有效的 URL 资源 | 支持本地文件或 URL;部署在云端时推荐使用 URL 输入 |
在 Claude Desktop 中使用
- 在 Claude 官网下载 Claude Desktop
- 前往
Claude > Settings > Developer > Edit Config > claude_desktop_config.json
,添加以下配置。完成配置后,重启 Claude Desktop。
spawn uvx ENOENT
,请在 command
中配置 uvx
的绝对路径
在 Cursor 中使用
- 通过 Cursor 官网 下载并安装 Cursor
- 前往
Cursor -> Preferences -> Cursor Settings -> Tools & Inrgrations -> MCP -> Add Custom MCP
,打开 MCP 工具配置文件

- 在
mcp.json
文件中,增加 MiniMax 账户配置信息
在 Cherry Studio 中使用
- 通过 Cherry Studio 官网 下载客户端
- 前往
Settings -> MCP Settings -> Add Server -> Import from JSON
,将以下代码粘贴到代码框中,确认
- 在对话框中,点击
MCP Settings
后,选择完成配置的“MiniMax MCP”即可使用

在客户端使用 MiniMax MCP JS 服务器
获取 API Key
- 访问 MiniMax 开放平台
- 点击“Create new secret key”按钮,输入项目名称以创建新的 API Key。
- 创建成功后,系统将展示 API Key。请务必复制并妥善保存,该密钥只会显示一次,无法再次查看。

Node.js 与 npm 安装
Node.js 是一个开源的 JavaScript 运行时环境,可以在浏览器之外运行 JavaScript 代码。它基于 Google 的 V8 引擎,具有高性能、事件驱动和非阻塞 I/O 的特点,适合构建高并发的网络服务、实时应用和微服务等场景。 npm 是随 Node.js 一起安装的默认包管理器,也是全球最大的软件注册中心。开发者可以通过 npm 搜索、安装、更新和管理依赖包(包括前端和后端代码模块),大幅简化开发流程。- 安装 Node.js 与 npm
- 验证安装是否完成
传输方式说明
MiniMax-MCP-JS 提供 studio、REST 和 SSE 三种传输方式,在使用时可按需选择特性 | stdio (默认) | REST | SSE |
---|---|---|---|
运行环境 | 本地运行 | 可本地或云端部署 | 可本地或云端部署 |
通信方式 | 通过标准输入输出通信 | 通过 HTTP 请求通信 | 通过服务器发送事件通信 |
适用场景 | 本地 MCP 客户端集成 | API 服务,跨语言调用 | 需要服务器推送的应用 |
输入限制 | 支持处理本地文件或有效的 URL 资源 | 当部署在云端时,建议使用 URL 作为输入 | 当部署在云端时,建议使用 URL 作为输入 |
在 Claude Desktop 中使用
- 在 Claude 官网下载 Claude Desktop
- 前往
Claude > Settings > Developer > Edit Config > claude_desktop_config.json
,添加以下配置。完成配置后,重启 Claude Desktop。
在 Cursor 中使用
- 通过 Cursor 官网 下载并安装 Cursor
- 前往
Cursor -> Preferences -> Cursor Settings -> Tools & Inrgrations -> MCP -> Add Custom MCP
,打开 MCP 工具配置文件

- 在
mcp.json
文件中,增加 MiniMax 账户配置信息
- 完成配置后,可以查看 MiniMax 目前支持的 mcp 工具

在 Cherry Studio 中使用
- 通过 Cherry Studio 官网 下载客户端
- 前往
Settings -> MCP Settings -> Add Server -> Import from JSON
,将以下代码粘贴到代码框中,确认
- 在对话框中,点击
MCP Settings
后,选择完成配置的“MiniMax MCP”即可使用

MiniMax MCP 使用示例
音频工具使用
- 选择合适的声音信息,播报晚间新闻片段

- 根据指定音频克隆声音,并指定克隆音色的 id

- 按照要求设计音色,并给定示例文本生成音频

音乐生成工具使用
参考提示词
图片生成工具使用
参考提示词

视频生成工具使用
参考提示词及图片
