项目简介

MiniMax MCP Server (JS) 是 MiniMax 官方推出的 Model Context Protocol (MCP) 服务器的 JavaScript/TypeScript 实现。它允许开发者快速搭建 MCP 服务器，为支持 MCP 协议的 LLM 客户端（如 Claude、Cursor）提供多模态能力，包括文本转语音、图像生成、视频生成和声音克隆等功能。

主要功能点

文本转语音 (TTS): 将文本转换为自然流畅的语音，支持多种音色、语速、音调、情感和音频格式。
图像生成: 根据文本描述生成高质量图像，支持多种模型和参数配置。
视频生成: 根据文本描述生成视频内容，支持多种模型，可以添加首帧图像。
声音克隆: 通过上传音频文件克隆声音，用于个性化语音合成。
动态配置: 支持多种配置方式，包括环境变量、命令行参数和请求参数，灵活适应不同部署环境。
兼容 MCP 平台: 可以部署在 ModelScope、MCP SO 等 MCP 平台上。

安装步骤

安装 Node.js 和 pnpm: 确保你的环境中已安装 Node.js 和包管理器 pnpm。如果未安装，请参考 Node.js 官网和 pnpm 官网进行安装。
全局安装 minimax-mcp-js (推荐): 打开终端，运行以下命令全局安装 'minimax-mcp-js'：
```
pnpm install -g minimax-mcp-js
```

服务器配置

要将 MiniMax MCP Server (JS) 集成到 MCP 客户端，你需要配置客户端的 MCP 服务器设置。以下是 Claude Desktop 和 Cursor 的配置示例，你需要根据你的 MCP 客户端进行相应配置。

Claude Desktop 配置 (claude_desktop_config.json):

{
  "mcpServers": {
    "minimax-mcp-js": {  // 服务器名称，可以自定义
      "command": "npx",  // 启动命令，通常为 npx 或 npm
      "args": [          // 启动参数
        "minimax-mcp-js" // 执行 minimax-mcp-js 命令
      ],
      "env": {           // 环境变量配置
        "MINIMAX_API_KEY": "<your-api-key-here>",         // 你的 MiniMax API 密钥 (必填)
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>", // 本地输出目录路径 (可选，默认为桌面)
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",   // MiniMax API Host (可选，默认为全球版)
        "MINIMAX_API_RESOURCE_MODE": "url"                // 资源模式 (可选，默认为 url，返回资源 URL)
      }
    }
  }
}

Cursor 配置 (Cursor Settings -> MCP -> Add new global MCP Server):

与 Claude Desktop 配置类似，在 Cursor 中添加新的全局 MCP Server，并填入上述 JSON 配置。

配置参数说明:

'server name': MCP 服务器的名称，在客户端中用于标识和选择服务器。
'command': 启动 MCP 服务器的命令，通常为 'npx' 或 'npm'，取决于你的环境和包管理工具。
'args': 传递给启动命令的参数，这里使用 'minimax-mcp-js' 执行服务器程序。
'env': 环境变量配置，用于配置 MiniMax API 密钥、输出路径、API Host 和资源模式等。
- 'MINIMAX_API_KEY': 必填，你的 MiniMax API 密钥，用于访问 MiniMax API 服务。请前往 MiniMax 平台获取。
- 'MINIMAX_MCP_BASE_PATH': 可选，本地文件输出的根目录，例如语音、图像、视频等文件将保存在此目录下。默认为用户桌面。
- 'MINIMAX_API_HOST': 可选，MiniMax API 的 Host 地址。默认为全球版 'https://api.minimaxi.chat'。中国大陆用户可能需要使用国内 Host。
- 'MINIMAX_API_RESOURCE_MODE': 可选，资源处理模式。
  - 'url': 默认值，服务器返回资源的 URL 链接。
  - 'local': 服务器将资源保存到本地 'MINIMAX_MCP_BASE_PATH' 指定的目录，并返回本地文件路径。

⚠️ 注意: 'MINIMAX_API_KEY' 必须与 'MINIMAX_API_HOST' 匹配。全球版和中国大陆版使用不同的 Host 和 API Key。

基本使用方法

配置完成后，你的 MCP 客户端即可通过 MiniMax MCP Server (JS) 提供的工具与 MiniMax API 交互。

例如，在 Claude 中：

你可以要求 Claude “使用 text_to_audio 工具将 '你好，世界' 转换为语音”。
Claude 会调用 'text_to_audio' 工具，MiniMax MCP Server (JS) 会调用 MiniMax TTS API 将文本转换为语音文件，并将语音文件保存到本地或返回 URL (取决于 'MINIMAX_API_RESOURCE_MODE' 配置)。
Claude 会将语音文件的路径或 URL 返回给你。

其他工具的使用方法类似，只需在提示词中明确指定要使用的工具名称和必要的参数即可。

⚠️ 警告: 使用这些工具可能会产生费用，请注意 MiniMax API 的计费规则。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

更多配置

信息