MiniMax

@MiniMax-AI/MiniMax-MCP
官方验证 Hosted
49 Stars 4.2w 次浏览 MiniMax-AI 更新于 2026-08-23

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

娱乐与多媒体

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "MiniMax": {
      "args": [
        "minimax-mcp"
      ],
      "command": "uvx",
      "env": {
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_KEY": "\u003cinsert-your-api-key-here\u003e",
        "MINIMAX_MCP_BASE_PATH": "\u003clocal-output-dir-path\u003e"
      }
    }
  }
}

该服务需要配置环境变量：MINIMAX_API_HOST、MINIMAX_API_KEY、MINIMAX_API_RESOURCE_MODE、MINIMAX_MCP_BASE_PATH

可用工具 （6 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

text_to_audio 13 个参数 需填 1 项

Convert text to audio with a given voice and save the output audio file to a given directory. Directory is optional, if not provided, the output file will be saved to $HOME/Desktop. Voice id is optional, if not provided, the default voice will be used. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: text (str): The text to convert to speech. voice_id (str, optional): The id of the voice to use. For example, "male-qn-qingse"/"audiobook_female_1"/"cute_boy"/"Charming_Lady"... model (string, optional): The model to use. speed (float, optional): Speed of the generated audio. Controls the speed of the generated speech. Values range from 0.5 to 2.0, with 1.0 being the default speed. vol (float, optional): Volume of the generated audio. Controls the volume of the generated speech. Values range from 0 to 10, with 1 being the default volume. pitch (int, optional): Pitch of the generated audio. Controls the speed of the generated speech. Values range from -12 to 12, with 0 being the default speed. emotion (str, optional): Emotion of the generated audio. Controls the emotion of the generated speech. Values range ["happy", "sad", "angry", "fearful", "disgusted", "surprised", "neutral"], with "happy" being the default emotion. sample_rate (int, optional): Sample rate of the generated audio. Controls the sample rate of the generated speech. Values range [8000,16000,22050,24000,32000,44100] with 32000 being the default sample rate. bitrate (int, optional): Bitrate of the generated audio. Controls the bitrate of the generated speech. Values range [32000,64000,128000,256000] with 128000 being the default bitrate. channel (int, optional): Channel of the generated audio. Controls the channel of the generated speech. Values range [1, 2] with 1 being the default channel. format (str, optional): Format of the generated audio. Controls the format of the generated speech. Values range ["pcm", "mp3","flac"] with "mp3" being the default format. language_boost (str, optional): Language boost of the generated audio. Controls the language boost of the generated speech. Values range ['Chinese', 'Chinese,Yue', 'English', 'Arabic', 'Russian', 'Spanish', 'French', 'Portuguese', 'German', 'Turkish', 'Dutch', 'Ukrainian', 'Vietnamese', 'Indonesian', 'Japanese', 'Italian', 'Korean', 'Thai', 'Polish', 'Romanian', 'Greek', 'Czech', 'Finnish', 'Hindi', 'auto'] with "auto" being the default language boost. Returns: Text content with the path to the output file and name of the voice used.

必填参数：text

list_voices 1 个参数

List all voices available. Only supports when api_host is https://api.minimax.chat Args: voice_type (str, optional): The type of voices to list. Values range ["all", "system", "voice_cloning"], with "all" being the default. Returns: Text content with the list of voices.

该工具无需必填参数，直接调用即可

voice_clone 5 个参数 需填 3 项

Clone a voice using provided audio files. The new voice will be charged upon first use. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: voice_id (str): The id of the voice to use. file (str): The path to the audio file to clone or a URL to the audio file. text (str, optional): The text to use for the demo audio. is_url (bool, optional): Whether the file is a URL. Defaults to False. Returns: Text content with the voice id of the cloned voice.

必填参数：voice_id、file、text

play_audio 2 个参数 需填 1 项

Play an audio file. Supports WAV and MP3 formats. Not supports video. Args: input_file_path (str): The path to the audio file to play. is_url (bool, optional): Whether the audio file is a URL. Returns: Text content with the path to the audio file.

必填参数：input_file_path

generate_video 4 个参数

Generate a video from a prompt. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: model (str, optional): The model to use. Values range ["T2V-01", "T2V-01-Director", "I2V-01", "I2V-01-Director", "I2V-01-live"]. "Director" supports inserting instructions for camera movement control. "I2V" for image to video. "T2V" for text to video. prompt (str): The prompt to generate the video from. When use Director model, the prompt supports 15 Camera Movement Instructions (Enumerated Values) -Truck: [Truck left], [Truck right] -Pan: [Pan left], [Pan right] -Push: [Push in], [Pull out] -Pedestal: [Pedestal up], [Pedestal down] -Tilt: [Tilt up], [Tilt down] -Zoom: [Zoom in], [Zoom out] -Shake: [Shake] -Follow: [Tracking shot] -Static: [Static shot] first_frame_image (str): The first frame image. The model must be "I2V" Series. output_directory (str, optional): The directory to save the video to. Returns: Text content with the path to the output video file.

该工具无需必填参数，直接调用即可

text_to_image 6 个参数

Generate a image from a prompt. COST WARNING: This tool makes an API call to Minimax which may incur costs. Only use when explicitly requested by the user. Args: model (str, optional): The model to use. Values range ["image-01"], with "image-01" being the default. prompt (str): The prompt to generate the image from. aspect_ratio (str, optional): The aspect ratio of the image. Values range ["1:1", "16:9","4:3", "3:2", "2:3", "3:4", "9:16", "21:9"], with "1:1" being the default. n (int, optional): The number of images to generate. Values range [1, 9], with 1 being the default. prompt_optimizer (bool, optional): Whether to optimize the prompt. Values range [True, False], with True being the default. output_directory (str, optional): The directory to save the image to. Returns: Text content with the path to the output image file.

该工具无需必填参数，直接调用即可

服务介绍

export

Documentation

快速开始使用 MCP 客户端

  1. 从MiniMax国内开放平台｜MiniMax国际开放平台获取你的 API 密钥。
  2. 安装uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv 仓库获取其他安装方法。
  3. 重要提示: API的服务器地址和密钥在不同区域有所不同，两者需要匹配，否则会有 invalid api key 的错误
地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

Claude Desktop

前往Claude > Settings > Developer > Edit Config > claude_desktop_config.json包含以下内容：

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "填写你的API密钥",
        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop",
        "MINIMAX_API_HOST": "填写API Host, https://api.minimaxi.com 或 https://api.minimax.io",
        "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
      }
    }
  }
}

⚠️ 注意：API Key需要与Host匹配。如果出现"API Error: invalid api key"错误，请检查您的API Host：

  • 国际版Host：https://api.minimax.io
  • 国内版Host：https://api.minimaxi.com

如果你使用Windows，你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help"，然后选择"Enable Developer Mode"。

Cursor

前往Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server添加上述配置。

你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互：

Transport

我们支持两种传输方式: stdio and sse.

stdio SSE
在本地部署运行 本地或云端部署均可
通过 stdout 进行通信 通过网络通信
输入：支持处理本地文件，或有效的URL资源 输入: 若部署在云端，建议使用URL进行输入

可用方法

方法 描述
text_to_audio 使用指定音色将文本生成音频
list_voices 查询所有可用音色
voice_clone 根据指定音频文件克隆音色
generate_video 根据指定 prompt 生成视频
text_to_image 根据指定 prompt 生成图片
music_generation 根据指定 prompt 和歌词生成音乐
voice_design 根据指定 prompt 生成音色和试听文本

更新日志

2025年7月2日

🆕 新增功能

  • 音色设计: 新增 voice_design 工具 - 根据描述性提示词创建自定义音色并生成试听音频
  • 视频生成增强: 新增 MiniMax-Hailuo-02 模型，支持超清画质和时长/分辨率控制
  • 音乐生成: 采用 music-1.5 模型增强 music_generation 工具

📈 功能增强

  • voice_design - 根据文本描述生成个性化音色
  • generate_video - 现在支持 MiniMax-Hailuo-02 模型，可选择 6s/10s 时长和 768P/1080P 分辨率
  • music_generation - 采用 music-1.5 模型进行高质量音乐创作

FAQ

1. invalid api key

请检查你获取的 API Key 和填写的 API Host 是否是同一地区的：

地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

2. spawn uvx ENOENT

请在你的终端输入一下命令，查看uvx命令的绝对路径：

which uvx

如果得到如下的输出 (如：/usr/local/bin/uvx)，更新mcp配置 ("command": "/usr/local/bin/uvx").

3. 如何用 generate_video 工具异步生成视频

在对话前设置一些规则:

或者放到本地客户端的规则中 (以 Cursor 为例):

使用示例

⚠️ 注意：使用这些工具可能会产生费用。

1. 播报晚间新闻片段

2. 克隆声音

3. 生成视频

4. 生成图像

查看源码 项目主页

相关 MCP 服务

抖
抖音小助手（by 云中江树）
zephyr/douyin-mcp-server
抖音运营助手，用于提取抖音无水印视频链接、视频文案、IP文案、素材文案以及文案对标改写等功能。 官方地址：https://github.com/yzfly/douyin-mcp-server
八字MCP
@cantian-ai/Bazi-MCP
为AI提供精准的八字排盘信息
ModelScope-Image-Generation-MCP
modelscope/ModelScope-Image-Generation-MCP
支持使用ModelScope上的模型进行文本到图像的生成。
小红书一站式自动化MCP（10月17可用）
Alobak/automation-xhs
小红书mcp服务， 1. 支持自动发布 2. 支持搜索笔记 3. 支持分析笔记内容 4. 支持多账户管理 5. 支持预发布（人工审核后发布） 6. 支持评论特定笔记引流，支持@指定人 支持mcp，api调用