M

MiniMax-MCP

@MiniMax-AI/MiniMax-MCP-1
Hosted
3 Stars 1.8k 次浏览 MiniMax-AI 更新于 2026-08-23

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

MCP 服务配置

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

{
  "mcpServers": {
    "MiniMax": {
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "command": "uvx",
      "env": {
        "MINIMAX_API_HOST": "api host, ​https://api.minimaxi.chat|https://api.minimax.chat",
        "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

服务介绍

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.minimaxi.chat （请注意额外的 "i" 字母） ​https://api.minimax.chat

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.minimax.chat 或 https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"
      }
    }
  }
}

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

  • 国际版Host：https://api.minimaxi.chat（请注意额外的 "i" 字母）
  • 国内版Host：https://api.minimax.chat

如果你使用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 生成图片

FAQ

1. invalid api key

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

地区 国际 国内
MINIMAX_API_KEY 获取密钥 MiniMax国际版 获取密钥 MiniMax
MINIMAX_API_HOST ​https://api.minimaxi.chat （请注意额外的 "i" 字母） ​https://api.minimax.chat

2. spawn uvx ENOENT

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

which uvx

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

使用示例

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

1. 播报晚间新闻片段

2. 克隆声音

3. 生成视频

4. 生成图像

查看源码 项目主页