https://github.com/MiniMax-AI/MiniMax-MCP

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.
https://github.com/MiniMax-AI/MiniMax-MCP

image-generation image-to-video mcp mcp-server mcp-tools text-to-image text-to-speech text-to-video video-generation voice-cloning

Last synced: about 20 hours ago
JSON representation

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Host: GitHub
URL: https://github.com/MiniMax-AI/MiniMax-MCP
Owner: MiniMax-AI
License: mit
Created: 2025-04-10T06:15:56.000Z (18 days ago)
Default Branch: main
Last Pushed: 2025-04-25T04:49:02.000Z (3 days ago)
Last Synced: 2025-04-25T05:33:51.609Z (3 days ago)
Topics: image-generation, image-to-video, mcp, mcp-server, mcp-tools, text-to-image, text-to-speech, text-to-video, video-generation, voice-cloning
Language: Python
Homepage: https://www.minimax.io/platform
Size: 378 KB
Stars: 230
Watchers: 4
Forks: 14
Open Issues: 4
Metadata Files:
- Readme: README-CN.md
- License: LICENSE

Awesome Lists containing this project

README

        ![export](https://github.com/MiniMax-AI/MiniMax-01/raw/main/figures/MiniMaxLogo-Light.png)



  

    

  

  

    

  

   

    

  

  

    

    





  

    

  

  

    

  

  

    

  





   

    

  



English Version




  MiniMax官方模型上下文协议(MCP)服务器，支持与强大的文本转语音和视频/图像生成API交互。允许MCP客户端如Claude Desktop、Cursor、Windsurf、OpenAI Agents等生成语音、克隆声音、生成视频、生成图像等功能。



## Documentation

- [English Documentation](README.md)

- [MiniMax-MCP-JS](https://github.com/MiniMax-AI/MiniMax-MCP-JS) - MiniMax MCP的官方JavaScript版本

## 快速开始使用 MCP 客户端

1. 从[MiniMax国内开放平台](https://platform.minimaxi.com/user-center/basic-information/interface-key)｜[MiniMax国际开放平台](https://www.minimax.io/platform/user-center/basic-information/interface-key)获取你的 API 密钥。

2. 安装`uv`（Python包管理器），使用`curl -LsSf https://astral.sh/uv/install.sh | sh`安装或查看`uv` [仓库](https://github.com/astral-sh/uv)获取其他安装方法。

3. **重要提示: API的服务器地址和密钥在不同区域有所不同**，两者需要匹配，否则会有 `invalid api key` 的错误

|地区| 国际  | 国内  |

|:--|:-----|:-----|

|MINIMAX_API_KEY| 获取密钥 [MiniMax国际版](https://www.minimax.io/platform/user-center/basic-information/interface-key) | 获取密钥 [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |

|MINIMAX_API_HOST| https://api.minimaxi.chat （请注意额外的 **"i"** 字母） | https://api.minimax.chat |

### Claude Desktop

前往`Claude > Settings > Developer > Edit Config > claude_desktop_config.json`包含以下内容：

```

{

  "mcpServers": {

    "MiniMax": {

      "command": "uvx",

      "args": [

        "minimax-mcp"

      ],

      "env": {

        "MINIMAX_API_KEY": "填写你的API密钥",

        "MINIMAX_MCP_BASE_PATH": "本地输出目录路径，如/User/xxx/Desktop",

        "MINIMAX_API_HOST": "填写API Host, https://api.minimax.chat 或 https://api.minimaxi.chat",

        "MINIMAX_API_RESOURCE_MODE": "可选配置，资源生成后的提供方式, 可选项为 [url|local], 默认为 url"

      }

    }

  }

}

```

⚠️ 注意：API Key需要与Host匹配。如果出现“API Error: invalid api key”错误，请检查您的API Host：

- 国际版Host：`https://api.minimaxi.chat`（请注意额外的 **"i"** 字母）

- 国内版Host：`https://api.minimax.chat` 

如果你使用Windows，你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help"，然后选择"Enable Developer Mode"。

### Cursor

前往`Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server`添加上述配置。

你的MCP客户端现在可以通过Claude Desktop和Cursor等这些工具与MiniMax交互：

## Transport

我们支持两种传输方式: stdio and sse.

| stdio  | SSE  |

|:-----|:-----|

| 在本地部署运行 | 本地或云端部署均可  |

|通过 stdout 进行通信| 通过网络通信|

|输入：支持处理本地文件，或有效的URL资源| 输入: 若部署在云端，建议使用URL进行输入|

## 可用方法

| 方法  | 描述  |

|-|-|

|`text_to_audio`|使用指定音色将文本生成音频|

|`list_voices`|查询所有可用音色|

|`voice_clone`|根据指定音频文件克隆音色|

|`generate_video`|根据指定 prompt 生成视频|

|`text_to_image`|根据指定 prompt 生成图片|

## FAQ

### 1. invalid api key

请检查你获取的 API Key 和填写的 API Host 是否是同一地区的：

|地区| 国际  | 国内  |

|:--|:-----|:-----|

|MINIMAX_API_KEY| 获取密钥 [MiniMax国际版](https://www.minimax.io/platform/user-center/basic-information/interface-key) | 获取密钥 [MiniMax](https://platform.minimaxi.com/user-center/basic-information/interface-key) |

|MINIMAX_API_HOST| https://api.minimaxi.chat （请注意额外的 **"i"** 字母） | https://api.minimax.chat |

### 2. spawn uvx ENOENT

请在你的终端输入一下命令，查看uvx命令的绝对路径：

```sh

which uvx

```

如果得到如下的输出 (如：/usr/local/bin/uvx)，更新mcp配置 ("command": "/usr/local/bin/uvx"). 

## 使用示例

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

### 1. 播报晚间新闻片段



### 2. 克隆声音



### 3. 生成视频





### 4. 生成图像

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/MiniMax-AI/MiniMax-MCP

Awesome Lists containing this project

README