README-CN.md

April 15, 2026 · View on GitHub

export

English Version

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

💡 推荐优先使用 MiniMax CLI (mmx-cli) — MiniMax 官方命令行工具，支持最新模型及更多功能（文本对话、图片理解、搜索、音乐翻唱等），支持作为 Claude Code、Cursor、OpenClaw 等 AI Agent 的技能接入。

Documentation

English Documentation
MiniMax-MCP-JS - MiniMax MCP的官方JavaScript版本

快速开始使用 MCP 客户端

从MiniMax国内开放平台｜MiniMax国际开放平台获取你的 API 密钥。
安装uv（Python包管理器），使用curl -LsSf https://astral.sh/uv/install.sh | sh安装或查看uv 仓库获取其他安装方法。
重要提示: 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 生成音色和试听文本