MCP 服务器

MiniMax MCP JS

基于 JavaScript 实现的 MiniMax MCP，可以通过兼容 MCP 的客户端与 MiniMax AI 服务进行交互，实现图像生成、视频生成、文本转语音和声音克隆等功能。

README

MiniMax MCP JS

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

</div>

文档

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

特性

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

安装

# 使用 pnpm 安装 (推荐)
pnpm add minimax-mcp-js

快速开始

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

使用 MCP 客户端快速开始

从 MiniMax International Platform 获取您的 API 密钥。
使用 pnpm 安装包：pnpm add minimax-mcp-js

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

全局安装 CLI 工具：

# 全局安装
pnpm install -g minimax-mcp-js

配置您的 MCP 客户端：

Claude Desktop

转到 Claude > Settings > Developer > Edit Config > claude_desktop_config.json 并包含：

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "minimax-mcp-js"
      ],
      "env": {
        "MINIMAX_API_KEY": "<your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "url"
      }
    }
  }
}

Cursor

转到 Cursor → Preferences → Cursor Settings → MCP → Add new global MCP Server 以添加上述配置。

⚠️ 注意: 如果在使用 MiniMax MCP JS 与 Cursor 时遇到“No tools found”错误，请将 Cursor 更新到最新版本。有关更多信息，请参见此讨论主题。

就是这样。您的 MCP 客户端现在可以通过这些工具与 MiniMax 交互。

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

# 在您的项目目录中
npm link

然后配置 Claude Desktop 或 Cursor 以使用如上所示的 npx。这将自动使用您链接的版本。

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

全球主机：https://api.minimaxi.chat (注意额外的 "i")
中国大陆主机：https://api.minimaxi.chat

配置

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

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

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

{
  "params": {
    "meta": {
      "auth": {
        "api_key": "your_api_key_here",
        "api_host": "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',
  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 密钥 (必需)
MINIMAX_API_KEY=your_api_key_here

# 输出文件的基本路径 (可选，默认为用户桌面)
MINIMAX_MCP_BASE_PATH=~/Desktop

# MiniMax API 主机 (可选，默认为 https://api.minimaxi.chat)
MINIMAX_API_HOST=https://api.minimaxi.chat

# 资源模式 (可选，默认为 'url')
# 选项: 'url' (返回 URL), 'local' (本地保存文件)
MINIMAX_API_RESOURCE_MODE=url

配置参数

参数	描述	默认值
apiKey	MiniMax API 密钥	None (必需)
apiHost	MiniMax API 主机	https://api.minimaxi.chat
basePath	输出文件的基本路径	用户桌面
resourceMode	资源处理模式, 'url' 或 'local'	url

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

全球主机：https://api.minimaxi.chat (注意额外的 "i")
中国大陆主机：https://api.minimaxi.chat

使用示例

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

1. 广播一段晚间新闻

2. 克隆一个声音

3. 生成一个视频

4. 生成图像

可用工具

文本转音频

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

参数：

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: 保存输出文件的路径（可选，如果未提供，则自动生成）

文本转图像

根据文本提示生成图像。

参数：

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: 保存输出文件的路径（可选，如果未提供，则自动生成）

生成视频

根据文本提示生成视频。

参数：

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

声音克隆

从音频文件克隆声音。

参数：

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

开发

设置

# 克隆存储库
git clone https://github.com/MiniMax-AI/MiniMax-MCP-JS.git
cd minimax-mcp-js

# 安装依赖
pnpm install

构建

# 构建项目
pnpm run build

运行

# 运行 MCP 服务器
pnpm start

许可证

MIT

MiniMax MCP JS

README

MiniMax MCP JS

文档

特性

安装

快速开始

使用 MCP 客户端快速开始

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

Claude Desktop

Cursor

配置

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

2. API 配置

3. 命令行参数

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

配置参数

使用示例

1. 广播一段晚间新闻

2. 克隆一个声音

3. 生成一个视频

4. 生成图像

可用工具

文本转音频

文本转图像

生成视频

声音克隆

开发

设置

构建

运行

许可证

推荐服务器