MiniMax MCP JS

MiniMax MCP JS

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

文档

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

发布说明

2025年7月22日

🔧 修复和改进

• TTS工具修复：固定参数处理 languageBoost 和 subtitleEnable 在 text_to_audio 工具
• API响应增强：TTS API可以返回音频文件和字幕文件，提供更完整的演讲到文本体验

2025年7月7日

🆕 新增功能

• 语音设计新 voice_design 工具-根据带有预览音频的描述性提示创建自定义语音
• 视频增强：已添加 MiniMax-Hailuo-02 具有超清晰质量和持续时间/分辨率控制的模型
• 音乐发生器：增强 music_generation 工具由 music-1.5 模型

📈 增强工具

• voice_design -根据文本描述生成个性化语音
• generate_video -现在支持MiniMax-Haileuo-02，持续时间为6s/10s，分辨率为768P/1080P
• music_generation -音乐-1.5模型的高品质音乐创作

特性

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

安装

通过Smithery安装

通过以下方式自动安装克劳德桌面版MiniMax MCP JS 史密瑟里:

npx -y @smithery/cli install @MiniMax-AI/MiniMax-MCP-JS --client claude

手动安装

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

快速开始

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

MCP客户端快速入门

1. 从获取API密钥 MiniMax国际平台.
2. 确保您已经安装
3. 重要提示：API主机和密钥在不同地区有所不同，它们必须匹配，否则您将收到 Invalid API key 错误。

|地区|全球|大陆| |:--|:-----|:-----| |MINIMAX_API_KEY |从获取 MiniMax全球 |去吧 极大极小 | |最小值_API_HOST |​https://api.minimaxi.chat（注意额外 “i”) | ​https://api.minimax.chat |

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

配置您的MCP客户端：

克劳德桌面

首选 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 包括：

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_HOST": "",
        "MINIMAX_API_KEY": "",
        "MINIMAX_MCP_BASE_PATH": "",
        "MINIMAX_RESOURCE_MODE": ""
      }
    }
  }
}

光标

首选 Cursor → Preferences → Cursor Settings → MCP → Add new global MCP Server 添加上述配置。

⚠️ 备注：如果您在使用带有游标的MiniMax MCP JS时遇到“未找到工具”错误，请将游标更新到最新版本。有关更多信息，请参阅此 讨论引线.

就是这样。您的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": "",
        "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.命令行参数

1. 全局安装CLI工具：

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

1. 当用作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. 请求级别配置 （通过 meta.auth 在每个API请求中）
2. 命令行参数
3. 环境变量
4. 配置文件
5. 默认值

这种优先级确保了跨不同部署场景的灵活性，同时维护了多租户环境的按请求配置功能。

配置参数

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

• 全球主机： https://api.minimaxi.chat （注意额外的“i”）
• 中国大陆主办单位： https://api.minimax.chat

示例用法

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

1.播放一段晚间新闻

2.克隆声音

3.生成视频

4.生成图像

5.生成音乐

6.语音设计

可用工具

文本转音频

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

工具名称： text_to_audio

参数：

• text：要转换的文本（必填）
• model：模型版本，选项为“speech-02-hd”、“speech-O-turbo”、“speech-01-hd”、“peech-01-turbo”，“speech-01-240228”，默认为“speaky-02-hd”
• voiceId：语音ID，默认为“男qn qingse”
• speed：语音速度，范围0.5-2.0，默认为1.0
• vol：音量，范围0.1-10.0，默认值为1.0
• pitch：音高，范围-12到12，默认值为0
• emotion：情绪，选项有“快乐”、“悲伤”、“愤怒”、“恐惧”、“厌恶”、“惊讶”、“中性”，默认为“快乐”。注意：此参数仅适用于“speech-02-hd”、“speech-O-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增强识别特定语言和方言的能力。

支持的值包括： “中文”、“中文、粤语”、“英语”、“阿拉伯语”、“俄语”、“西班牙语”、“法语”、“葡萄牙语”、“德语”、“土耳其语”、“荷兰语”、“乌克兰语”、“越南语”、“印尼语”、《日语》、“意大利语”、“韩语”、“泰语”、“波兰语”、“罗马尼亚语”、

• stream：启用流式输出
• subtitleEnable：该参数控制是否启用字幕服务。模型必须是“speech-01-turbo”或“speech-01-hd”。如果不提供此参数，则默认值为false
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）
• outputFile：保存输出文件的路径（可选，如果未提供，则自动生成）

播放音频

播放音频文件。支持WAV和MP3格式。不支持视频。

工具名称： play_audio

参数：

• inputFilePath：要播放的音频文件的路径（必需）
• isUrl：音频文件是否为URL，默认值为false

语音克隆

从音频文件中克隆语音。

工具名称： voice_clone

参数：

• audioFile：音频文件的路径（必需）
• voiceId：语音ID（必填）
• text：演示音频文本（可选）
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）

文本到图像

根据文本提示生成图像。

工具名称： 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：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）
• outputFile：保存输出文件的路径（可选，如果未提供，则自动生成）
• asyncMode：是否使用异步模式。默认为False。如果为True，则视频生成任务将异步提交，响应将返回task_id。应使用 query_video_generation 工具来检查任务的状态并获得结果。（可选）

生成视频

根据文本提示生成视频。

工具名称： generate_video

参数：

• prompt：视频描述（必填）
• model：型号版本，选项为'T2V-01'、'T2V-01-Director'、'I2V-01'，'I2V-01-Director'、'V2V-01-live'、'S2V-01'和'MiniMax-Hailoo-02'，默认为'MiniMax-Hailuo-02'
• firstFrameImage：第一帧图像的路径（可选）
• duration：视频的持续时间。型号必须为“MiniMax-Hailoo-02”。值可以是6和10。（可选）
• resolution：视频的分辨率。型号必须为“MiniMax-Hailoo-02”。值范围\[“768P”、“1080P”\]。（可选）
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）
• outputFile：保存输出文件的路径（可选，如果未提供，则自动生成）
• asyncMode：是否使用异步模式。默认为False。如果为True，则视频生成任务将异步提交，响应将返回task_id。应使用 query_video_generation 工具来检查任务的状态并获得结果。（可选）

查询视频生成状态

查询视频生成任务的状态。

工具名称： query_video_generation

参数：

• taskId：要查询的任务ID。应该是由返回的task_id generate_video 工具if async_mode 这是真的。（必填）
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）

生成音乐

根据提示和歌词生成音乐。

工具名称： music_generation

参数：

• prompt：音乐创作灵感描述风格、情绪、场景等。例如：“流行音乐，悲伤，适合雨夜”。字符范围：\[10300\]。（必填）
• lyrics：音乐一代的歌词。使用换行符（\\n）分隔每一行歌词。支持歌词结构标签\[Intro\]\[Verse\]\[Chorus\]\[Bridge\]\[Outro\]，以增强音乐性。字符范围：\[10600\]（每个汉字、标点符号和字母计为1个字符）。（必填）
• sampleRate：生成音乐的采样率。值：\[16000、24000、32000、44100\]，默认值为32000。（可选）
• bitrate：生成音乐的比特率。值：\[32000、64000、128000、256000\]，默认值为128000。（可选）
• format：生成音乐的格式。值：\[“mp3”、“wav”、“pcm”\]，默认值为“mp3”。（可选）
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）

语音设计

根据描述提示生成语音。

工具名称： voice_design

参数：

• prompt：生成语音的提示。（必填）
• previewText：预览语音的文本。（必填）
• voiceId：要使用的语音id。例如，“男qn qingse”/“有声读物_female_1”/“可爱男孩”/“魅力女孩”。..（可选）
• outputDirectory：保存输出文件的目录。 outputDirectory 是相对于 MINIMAX_MCP_BASE_PATH （或 basePath 在配置中）。最终保存路径为 ${basePath}/${outputDirectory}例如，如果 MINIMAX_MCP_BASE_PATH=~/Desktop 和 outputDirectory=workspace，输出将保存到 ~/Desktop/workspace/.（可选）

常见问题解答

1.如何使用 generate_video 在异步模式下

开始前定义完成规则：

或者，可以在IDE设置中配置这些规则（例如Cursor）：

发展

设置

# 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

许可证

麻省理工学院