极小极大-MCP-JS

Name: 极小极大-MCP-JS
Author: MiniMax-AI

作者：MiniMax-AI90 星标更新：2025-07-22

安装使用来源：spider==github.com

项目介绍

【技术文档摘要】： export

MiniMax MCP JS

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

文档

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

发布说明

2025年7月22日

🔧 修复与改进

TTS 工具修复：修复了 text_to_audio 工具中的 languageBoost 和 subtitleEnable 参数处理问题
API 响应增强：TTS API 可以返回音频文件和字幕文件，提供更完整的语音到文本体验

2025年7月7日

🆕 新功能

语音设计：新的 voice_design 工具 - 根据描述提示创建自定义声音，并带有预览音频
视频增强：添加了具有超清晰质量并支持时长/分辨率控制的 MiniMax-Hailuo-02 模型
音乐生成：增强了由 music-1.5 模型驱动的 music_generation 工具

📈 工具增强

voice_design - 从文本描述生成个性化的声音
generate_video - 现在支持 MiniMax-Hailuo-02，具有 6s/10s 时长和 768P/1080P 分辨率选项
music_generation - 使用 music-1.5 模型进行高质量音乐创作

功能

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

安装

通过 Smithery 安装

要通过 Smithery 自动安装 MiniMax MCP JS 到 Claude Desktop：

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

手动安装

# 使用 pnpm 安装（推荐）
pnpm add minimax-mcp-js

快速开始

MiniMax MCP JS 实现了 Model Context Protocol (MCP) 规范，可以作为服务器与兼容 MCP 的客户端（如 Claude AI）交互。

使用 MCP 客户端快速开始

从 MiniMax 国际平台获取您的 API 密钥。
确保已安装 Node.js 和 npm
重要：不同地区的 API HOST&KEY 不同，必须匹配，否则您会收到“无效 API 密钥”错误。

地区	全球	大陆
MINIMAX_API_KEY	从 MiniMax 全球获取	从 MiniMax 获取
MINIMAX_API_HOST	https://api.minimaxi.chat (注意额外的 "i")	https://api.minimax.chat

使用 MCP 客户端（推荐）

配置您的 MCP 客户端：

Claude Desktop

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

{
  "mcpServers": {
    "minimax-mcp-js": {
      "command": "npx",
      "args": [
        "-y",
        "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": "<本地输出目录路径，例如 /User/xxx/Desktop>",
        "MINIMAX_RESOURCE_MODE": "<可选，[url|local]，默认为 url，音频/图像/视频是下载到本地或以 URL 格式提供>"
      }
    }
  }
}

Cursor

前往 Cursor → 首选项 → Cursor 设置 → MCP → 添加新的全局 MCP 服务器 添加上述配置。

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

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

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

# 在您的项目目录中
npm link

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

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

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

传输模式

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

功能	stdio（默认）	REST	SSE
环境	仅本地	本地或云部署	本地或云部署
通信	通过 `标准 I/O`	通过 `HTTP 请求`	通过 `服务器推送事件`
使用场景	本地 MCP 客户端集成	API 服务，跨语言调用	需要服务器推送的应用程序
输入限制	支持 `本地文件` 或 `URL` 资源	当部署在云端时，建议使用 `URL` 输入	当部署在云端时，建议使用 `URL` 输入

配置

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

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

在平台托管环境中（如 ModelScope 或其他 MCP 平台），您可以通过