M

MiniMax-01

freya123/slftest1111
Hosted
0 Stars 234 次浏览 沙漠里的猫 更新于 2026-08-23

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

开发者工具

MCP 服务配置

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

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

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

可用工具 （7 个）

该服务在 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. output_directory (str): The directory to save the audio to. Returns: Text content with the path to the output file and name of the voice used.

必填参数：text

list_voices 1 个参数

List all voices available. 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. output_directory (str): The directory to save the demo audio to. 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 5 个参数

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): The directory to save the video to. async_mode (bool, optional): Whether to use async mode. Defaults to False. If True, the video generation task will be submitted asynchronously and the response will return a task_id. Should use `query_video_generation` tool to check the status of the task and get the result. Returns: Text content with the path to the output video file.

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

query_video_generation 2 个参数 需填 1 项

Query the status of a video generation task. Args: task_id (str): The task ID to query. Should be the task_id returned by `generate_video` tool if `async_mode` is True. output_directory (str): The directory to save the video to. Returns: Text content with the status of the task.

必填参数：task_id

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): The directory to save the image to. Returns: Text content with the path to the output image file.

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

服务介绍

export

文档

使用 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 全球 获取 从 MiniMax 获取
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

Claude Desktop

前往 Claude > 设置 > 开发者 > 编辑配置 > claude_desktop_config.json 并添加以下内容：

{
"mcpServers": {
"MiniMax": {
"command": "uvx",
"args": [
"minimax-mcp",
"-y"
],
"env": {
"MINIMAX_API_KEY": "在此处插入您的 API 密钥",
"MINIMAX_MCP_BASE_PATH": "本地输出目录路径，例如 /User/xxx/Desktop",
"MINIMAX_API_HOST": "API 主机, https://api.minimax.io | https://api.minimaxi.com",
"MINIMAX_API_RESOURCE_MODE": "可选, [url|local], 默认为 url, 音频/图像/视频可以下载到本地或以 URL 格式提供"
}
}
}
}

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

  • 全球主机：https://api.minimax.io
  • 中国大陆主机：https://api.minimaxi.com

如果您使用的是 Windows 系统，则需要在 Claude Desktop 中启用“开发者模式”才能使用 MCP 服务器。点击左上角的汉堡菜单中的“帮助”，然后选择“启用开发者模式”。

Cursor

前往 Cursor -> 首选项 -> Cursor 设置 -> MCP -> 添加新的全局 MCP 服务器 来添加上述配置。

就这样。您的 MCP 客户端现在可以通过这些工具与 MiniMax 进行交互：

传输

我们支持两种传输类型：stdio 和 sse。

stdio SSE
本地运行 可以部署在本地或云端
通过 stdout 通信 通过 网络 通信

可用工具

工具 描述
text_to_audio 使用给定的声音将文本转换为音频
list_voices 列出所有可用的声音
voice_clone 使用提供的音频文件克隆声音
generate_video 根据提示生成视频
text_to_image 根据提示生成图像
query_video_generation 查询视频生成任务的结果

常见问题

1. 无效的 API 密钥

请确保您的 API 密钥和 API 主机与所在区域对齐

区域 全球 国内
MINIMAX_API_KEY 从 MiniMax Global 获取 从 MiniMax 获取
MINIMAX_API_HOST https://api.minimax.io https://api.minimaxi.com

2. spawn uvx ENOENT

请通过在终端中运行以下命令确认其绝对路径：
sh
which uvx

一旦您获得了绝对路径（例如，/usr/local/bin/uvx），请更新您的配置以使用该路径（例如，“command”: “/usr/local/bin/uvx”）。

3. 如何在异步模式下使用 generate_video

在开始前定义完成规则：

或者，这些规则可以在您的 IDE 设置中配置（例如，光标）：

使用示例

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

1. 播放一段晚间新闻

2. 克隆一个声音

3. 生成一个视频

4. 生成图像

查看源码 项目主页

相关 MCP 服务

LeetCode(力扣)
jinzcdev/leetcode-mcp-server
MCP 服务器实现 LeetCode API 集成，支持自动化获取编程题库、用户数据和竞赛信息。
可视化图表-MCP-Server
antvis/mcp-server-chart
这是一个基于AntV的模型上下文协议服务器，用于生成图表。它支持超过20种类型的图表，并且可以与多种桌面应用程序和平台一起使用。
微软Playwright
@microsoft/playwright-mcp
一种模型上下文协议服务器，它使大型语言模型能够通过结构化的可访问性快照与网页交互，而无需使用视觉模型或截图。
MCP上下文模型文档
@upstash/context7-mcp
一种模型上下文协议服务器，它从库中直接获取最新、特定版本的文档和代码示例并将其引入LLM提示中，帮助开发人员在无需过时或虚构信息的情况下获得准确的答案。