基于 MiniMax 官方 MCP 修改，仅保留语音/音频相关功能。

支持 MCP 客户端（如 Claude Desktop、Cursor、Windsurf、OpenAI Agents 等）进行文本转语音、声音克隆、声音设计、音频播放等操作。

API 地区对照（Key 和 Host 必须匹配同一地区，否则会报 invalid api key）：

支持 stdio 和 SSE 两种传输模式：

适合你修改了代码、想直接用本地版本的场景。

git clone https://github.com/upseem/MiniMax-MCP-Voice.git
cd MiniMax-MCP-Voice
uv venv
source .venv/bin/activate   # Windows: .venv\Scripts\activate
uv pip install -e .

在项目根目录创建 .env 文件：

MINIMAX_API_KEY=你的API密钥
MINIMAX_API_HOST=https://api.minimaxi.com
MINIMAX_MCP_BASE_PATH=~/Desktop
MINIMAX_API_RESOURCE_MODE=url

Claude Desktop

前往 Claude > Settings > Developer > Edit Config > claude_desktop_config.json：

{
  "mcpServers": {
    "MiniMax-Voice": {
      "command": "/你的项目路径/MiniMax-MCP-Voice/.venv/bin/python",
      "args": [
        "-m", "minimax_mcp.server"
      ],
      "env": {
        "MINIMAX_API_KEY": "你的API密钥",
        "MINIMAX_API_HOST": "https://api.minimaxi.com",
        "MINIMAX_MCP_BASE_PATH": "~/Desktop",
        "MINIMAX_API_RESOURCE_MODE": "url"
      }
    }
  }
}

将 /你的项目路径/ 替换为你实际的项目路径。可通过 which python（在虚拟环境中）获取完整路径。

Cursor

前往 Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server，添加同样的配置。

source .venv/bin/activate
python -m minimax_mcp.server

source .venv/bin/activate
python -m minimax_mcp.server --transport sse --port 8000

然后在 MCP 客户端中配置 SSE 地址：

{
  "mcpServers": {
    "MiniMax-Voice": {
      "url": "http://localhost:8000/sse"
    }
  }
}

如果你不需要修改代码，可以直接使用 PyPI 上的原版包（注意：原版包含视频/图片/音乐等全部功能）。

curl -LsSf https://astral.sh/uv/install.sh | sh

Claude Desktop

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "你的API密钥",
        "MINIMAX_API_HOST": "https://api.minimaxi.com",
        "MINIMAX_MCP_BASE_PATH": "~/Desktop",
        "MINIMAX_API_RESOURCE_MODE": "url"
      }
    }
  }
}

如果 uvx 命令找不到，请运行 which uvx 获取绝对路径，然后将 "command": "uvx" 替换为 "command": "/绝对路径/uvx"。

适合团队共享或部署到服务器的场景。

git clone https://github.com/upseem/MiniMax-MCP-Voice.git
cd MiniMax-MCP-Voice
uv venv && source .venv/bin/activate
uv pip install -e .

# 设置环境变量
export MINIMAX_API_KEY="你的API密钥"
export MINIMAX_API_HOST="https://api.minimaxi.com"
export MINIMAX_MCP_BASE_PATH="/data/output"
export MINIMAX_API_RESOURCE_MODE="url"

# 启动 SSE 服务
python -m minimax_mcp.server --transport sse --host 0.0.0.0 --port 8000

在 MCP 客户端中配置远程 SSE 地址：

{
  "mcpServers": {
    "MiniMax-Voice": {
      "url": "https://你的服务器地址:8000/sse"
    }
  }
}

建议在云端部署时将 MINIMAX_API_RESOURCE_MODE 设为 url，这样生成的音频以 URL 形式返回，无需下载到服务器本地。

将文本转换为音频文件，支持丰富的参数控制。

使用提供的音频文件克隆新声音，分三步：上传文件 -> 克隆声音 -> 生成演示音频。

本地播放音频文件，依赖 ffplay（需安装 ffmpeg）。

用自然语言描述想要的声音特征，自动生成对应声音并预览。

请确保 API Key 和 API Host 来自同一地区：

• 国际版：Key 从 MiniMax 国际版 获取，Host 为 https://api.minimax.io
• 国内版：Key 从 MiniMax 国内版 获取，Host 为 https://api.minimaxi.com

在终端运行以下命令获取 uvx 的绝对路径：

which uvx

然后将配置中的 "command": "uvx" 替换为完整路径，如 "command": "/usr/local/bin/uvx"。

请确保已安装 ffmpeg：

# macOS
brew install ffmpeg

# Ubuntu/Debian
sudo apt install ffmpeg

# Windows
# 从 https://ffmpeg.org/download.html 下载并添加到 PATH

MIT License