MiniMax AISAFE

[](https://mseep.ai/app/zth0828-mmx-mcp-server)

一个统一的 MiniMax 全模态 MCP Server,基于 mmx CLI 封装,支持文本、搜索、图像理解、图像生成、语音合成、视频生成、音乐生成和配额查询。

English README

快速开始(一句话配置)

如果你使用的是 Claude Code、OpenCode 或其他支持 MCP 的 AI CLI 工具,直接把下面这段话丢给 AI:

帮我安装并配置 mmx-mcp-server: 1. 全局安装 mmx-cli(npm install -g mmx-cli) 2. 克隆 https://github.com/zth0828/mmx-mcp-server 到任意目录,执行 npm install && npm run build 3. 在我的 MCP 配置文件(如 ~/.claude/settings.json)里添加 mmx server,指向构建产物 dist/index.js 4. 向我要 MiniMax API Key,并通过 env.MINIMAX_API_KEY 注入 5. 完成后告诉我配置结果

手动安装

1. 安装 mmx CLI(如果尚未安装)

npm install -g mmx-cli

验证安装:

mmx --version

2. 安装并构建 MCP Server

git clone https://github.com/zth0828/mmx-mcp-server.git
cd mmx-mcp-server
npm install
npm run build

3. 配置 API Key

在 MCP 客户端配置(如 ~/.claude/settings.json)中添加:

方式一:环境变量传 API Key(推荐)

{
"mcpServers": {
"mmx": {
"command": "node",
"args": ["/path/to/mmx-mcp-server/dist/index.js"],
"env": {
"MINIMAX_API_KEY": "sk-xxxxx"
}
}
}
}

方式二:命令行参数传 API Key

适合不方便写 env 的 MCP 客户端:

{
"mcpServers": {
"mmx": {
"command": "node",
"args": [
"/path/to/mmx-mcp-server/dist/index.js",
"--api-key",
"sk-xxxxx"
]
}
}
}

方式三:依赖 mmx CLI 本地登录

如果前两种方式都没配,Server 会自动回退到 mmx CLI 自身的认证状态(需提前执行 mmx auth login --api-key sk-xxxxx)。这种方式仅适合本机使用。

自定义输出目录(可选)

默认情况下,生成的图片、视频、音乐、语音会自动保存到 当前工作目录 下的子文件夹:

• mmx_image/ — 图片
• mmx_video/ — 视频
• mmx_music/ — 音乐
• mmx_speech/ — 语音

如果你希望统一放到其他位置,可以通过环境变量 MMX_OUTPUT_DIR 修改:

{
"mcpServers": {
"mmx": {
"command": "node",
"args": ["/path/to/mmx-mcp-server/dist/index.js"],
"env": {
"MINIMAX_API_KEY": "sk-xxxxx",