MiniMax MCP JS

JavaScript/TypeScript 实现的 MiniMax MCP，提供图像生成、视频生成、文本转语音等功能。

文档

• 中文文档
• Python 版本 - MiniMax MCP 的官方 Python 实现

功能

• 文字转语音 (TTS)
• 图像生成
• 视频生成
• 语音克隆
• 动态配置（支持环境变量和请求参数）
• 兼容 MCP 平台托管（如 ModelScope 和其他 MCP 平台）

安装

# Install with pnpm (recommended)
pnpm add minimax-mcp-js

快速开始

MiniMax MCP JS 实现了 模型上下文协议 (MCP) 规范，可以用作服务器与兼容 MCP 的客户端（如 Claude AI）进行交互。

使用 MCP 客户端快速开始

1. 从 MiniMax 国际平台 获取您的 API 密钥。
2. 使用 pnpm 安装 minimax-mcp-js：pnpm add minimax-mcp-js
3. 重要：不同地区的 API HOST&KEY 是不同的，它们必须匹配，否则您会收到 无效的 API 密钥 错误。

与 MCP 客户端一起使用（推荐）

1. 全局安装 CLI 工具：

# Install globally
pnpm install -g minimax-mcp-js

1. 配置您的 MCP 客户端：

Claude 桌面版

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

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "<https://api.minimaxi.chat|https://api.minimax.chat>",
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path, such as /User/xxx/Desktop>",
        "MINIMAX_RESOURCE_MODE": "<optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format>"
      }
    }
  }
}

Cursor

前往 光标 → 偏好设置 → 光标设置 → MCP → 添加新的全局MCP服务器 以添加上述配置。

⚠️ 注意：如果您在使用MiniMax MCP JS与Cursor时遇到“未找到工具”的错误，请将您的Cursor更新到最新版本。更多信息，请参阅此讨论帖。

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

对于本地开发：
在本地开发时，您可以使用npm link来测试您的更改：

# In your project directory
npm link

然后按照上述方法配置Claude Desktop或Cursor使用npx。这将自动使用您链接的版本。

⚠️ 注意：API密钥需要与主机地址匹配。全球版和中国大陆版使用不同的主机：

• 全球主机：https://api.minimaxi.chat（请注意额外的"i"）
• 中国大陆主机：https://api.minimaxi.chat

传输模式

MiniMax MCP JS支持三种传输模式：

配置

MiniMax-MCP-JS提供了多种灵活的配置方法以适应不同的使用场景。配置优先级从高到低如下所示：

1. 请求参数配置（最高优先级）

在平台托管环境（如ModelScope或其他MCP平台）中，您可以通过请求参数中的meta.auth对象为每个请求提供独立的配置：

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "<https://api.minimaxi.chat|https://api.minimaxi.chat>",
        "base_path": "/path/to/output",
        "resource_mode": "url"
      }
    }
  }
}

这种方法支持多租户使用，每个请求可以使用不同的API密钥和配置。

2. API配置

当作为其他项目中的模块使用时，您可以通过startMiniMaxMCP函数传递配置：

import { startMiniMaxMCP } from 'minimax-mcp-js';

await startMiniMaxMCP({
  apiKey: 'your_api_key_here',
  apiHost: 'https://api.minimaxi.chat', // Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat
  basePath: '/path/to/output',
  resourceMode: 'url'
});

3. 命令行参数

当作为CLI工具使用时，您可以通过命令行参数提供配置：

minimax-mcp-js --api-key your_api_key_here --api-host https://api.minimaxi.chat --base-path /path/to/output --resource-mode url

4. 环境变量（最低优先级）

最基本的配置方法是通过环境变量：

# MiniMax API Key (required)
MINIMAX_API_KEY=your_api_key_here

# Base path for output files (optional, defaults to user's desktop)
MINIMAX_MCP_BASE_PATH=~/Desktop

# MiniMax API Host (optional, defaults to https://api.minimaxi.chat, Global Host - https://api.minimaxi.chat, Mainland Host - https://api.minimax.chat)
MINIMAX_API_HOST=https://api.minimaxi.chat

# Resource mode (optional, defaults to 'url')
# Options: 'url' (return URLs), 'local' (save files locally)
MINIMAX_RESOURCE_MODE=url

配置优先级

当使用多种配置方法时，以下是从高到低的优先级顺序：

1. 请求级配置（通过每个API请求中的meta.auth）
2. 命令行参数
3. 环境变量
4. 配置文件
5. 默认值

这种优先级排序确保了不同部署场景下的灵活性，同时保持了多租户环境下每个请求的配置能力。

配置参数

⚠️ 注意：API 密钥需要与主机地址匹配。全球版本和中国大陆版本使用不同的主机：

• 全球主机：https://api.minimaxi.chat（注意多了一个 "i"）
• 中国大陆主机：https://api.minimaxi.chat

使用示例

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

1. 播放一段晚间新闻

2. 克隆一个声音

3. 生成一个视频

4. 生成图片

可用工具

文本转音频

将文本转换为语音音频文件。

工具名称：text_to_audio

参数：

• text: 要转换的文本（必填）
• model: 模型版本，选项包括 'speech-02-hd', 'speech-02-turbo', 'speech-01-hd', 'speech-01-turbo', 'speech-01-240228', 'speech-01-turbo-240228'，默认为 'speech-02-hd'
• voiceId: 声音ID，默认为 'male-qn-qingse'
• speed: 语速，范围0.5-2.0，默认为1.0
• vol: 音量，范围0.1-10.0，默认为1.0
• pitch: 音调，范围-12到12，默认为0
• emotion: 情感，选项包括 'happy', 'sad', 'angry', 'fearful', 'disgusted', 'surprised', 'neutral'，默认为 'happy'。注意：此参数仅适用于'speech-02-hd', 'speech-02-turbo', 'speech-01-turbo', 'speech-01-hd'模型
• format: 音频格式，选项包括 'mp3', 'pcm', 'flac', 'wav'，默认为 'mp3'
• sampleRate: 采样率（Hz），选项包括 8000, 16000, 22050, 24000, 32000, 44100，默认为 32000
• bitrate: 比特率（bps），选项包括 64000, 96000, 128000, 160000, 192000, 224000, 256000, 320000，默认为 128000
• channel: 音频声道数，选项为 1 或 2，默认为 1
• languageBoost: 语言增强，默认为 'auto'
• latexRead: 启用LaTeX公式朗读
• pronunciationDict: 发音词典
• stream: 启用流式输出
• subtitleEnable: 启用字幕生成
• outputDirectory: 保存输出文件的目录（可选）
• outputFile: 保存输出文件的路径（可选，如果未提供则自动生成）

文本转图片

根据文本提示生成图片。

工具名称: text_to_image

参数：

• prompt: 图像描述（必填）
• model: 模型版本，默认为 'image-01'
• aspectRatio: 纵横比，默认为 '1:1'，选项有 '1:1', '16:9','4:3', '3:2', '2:3', '3:4', '9:16', '21:9'
• n: 要生成的图片数量，范围1-9，默认为1
• promptOptimizer: 是否优化提示，默认为 true
• subjectReference: 角色参考的本地图片文件路径或公共URL（可选）
• outputDirectory: 保存输出文件的目录（可选）
• outputFile: 保存输出文件的路径（可选，如果未提供则自动生成）

生成视频

根据文本提示生成视频。

工具名称: generate_video

参数：

• prompt: 视频描述（必填）
• model: 模型版本，选项包括 'T2V-01', 'T2V-01-Director', 'I2V-01', 'I2V-01-Director', 'I2V-01-live', 'S2V-01'，默认为 'T2V-01'
• firstFrameImage: 第一帧图像的路径（可选）
• outputDirectory: 保存输出文件的目录（可选）
• outputFile: 保存输出文件的路径（可选，如果未提供则自动生成）

语音克隆

从音频文件中克隆一个声音。

工具名称: voice_clone

参数：

• audioFile: 音频文件路径（必填）
• voiceId: 声音ID（必填）
• text: 用于演示音频的文本（可选）
• outputDirectory: 保存输出文件的目录（可选）

开发

设置

# Clone the repository
git clone https://github.com/MiniMax-AI/MiniMax-MCP-JS.git
cd minimax-mcp-js

# Install dependencies
pnpm install

构建

# Build the project
pnpm run build

运行

# Run the MCP server
pnpm start

许可证

MIT