minimax文生图mcp

项目地址：WangYuyan/minimax-image-mcp

MiniMax 文生图 MCP 配置详细指南

本文档提供在 Windows/macOS/Linux 系统上配置 MiniMax 文生图 MCP 的完整步骤。

前提条件

Windows 10/11、macOS 10.14+ 或 Linux
Claude Code 已安装
MiniMax 账号

安装 Node.js

Windows

访问 Node.js 官网
下载 LTS 版本（推荐 v18 或更高）
运行安装程序，一路点击 "Next"
验证安装：
bash 复制代码
```
node --version
npm --version
```

macOS

方式一：使用 Homebrew

bash 复制代码

brew install node

方式二：访问 Node.js 官网下载 pkg 安装包

Linux (Ubuntu/Debian)

bash 复制代码

sudo apt update
sudo apt install nodejs npm

验证：

bash 复制代码

node --version
npm --version

获取 MiniMax API Key

访问 MiniMax 开放平台：api.minimaxi.com
注册账号（如果还没有）
登录后进入控制台
在「API Key」或「密钥管理」页面创建新密钥
复制生成的 API Key，妥善保存

注意：API Key 就像密码，请勿泄露给他人。

项目安装

1. 克隆或下载项目

如果你从 Git 克隆：

bash 复制代码

git clone <repository-url>
cd minimax-image-mcp

或者将项目文件夹放到合适的位置，例如：

Windows: D:\MCP\minimax-image-mcp
macOS/Linux: ~/MCP/minimax-image-mcp

2. 安装依赖

打开终端，进入项目目录：

bash 复制代码

cd D:\MCP\minimax-image-mcp
npm install

3. 构建项目

bash 复制代码

npm run build

构建成功后，会在 build 目录下生成 index.js 文件。

Claude Code 配置

方式一：全局配置（所有项目可用）

Windows

打开文件资源管理器
地址栏输入 %USERPROFILE%\.claude.json 打开配置文件
在 mcpServers 中添加配置：

json 复制代码

{
  "mcpServers": {
    "minimax-image": {
      "command": "node",
      "args": ["D:/MCP/minimax-image-mcp/build/index.js"],
      "env": {
        "MINIMAX_API_KEY": "你的API密钥"
      }
    }
  }
}

macOS/Linux

bash 复制代码

nano ~/.claude.json

找到 mcpServers 部分，添加：

json 复制代码

"minimax-image": {
  "command": "node",
  "args": ["/Users/你的用户名/MCP/minimax-image-mcp/build/index.js"],
  "env": {
    "MINIMAX_API_KEY": "你的API密钥"
  }
}

方式二：项目级配置（仅当前项目可用）

在项目根目录创建或编辑 .claude.json：

json 复制代码

{
  "mcpServers": {
    "minimax-image": {
      "command": "node",
      "args": ["./build/index.js"],
      "env": {
        "MINIMAX_API_KEY": "你的API密钥"
      }
    }
  }
}

配置说明

配置项	说明
`command`	运行命令，固定为 `node`
`args`	MCP 服务器脚本路径，使用正斜杠 `/`
`env.MINIMAX_API_KEY`	你的 MiniMax API 密钥

路径注意 ：Windows 路径建议使用正斜杠，如 D:/MCP/...，否则可能导致无法识别。

验证配置

1. 重启 Claude Code

配置完成后，需要完全关闭并重新打开 Claude Code。

2. 检查 MCP 服务器状态

在 Claude Code 中输入：

bash 复制代码

/mcp

应该能看到 minimax-image 服务器。

如果没有看到，尝试：

bash 复制代码

/doctor

查看是否有配置错误。

3. 测试生成图片

配置正确后，可以尝试生成一张测试图片：

复制代码

用 text_to_image 工具生成一张测试图片

使用方法

基本语法

css 复制代码

使用 text_to_image 工具生成 [描述]，比例 [比例]，质量 [质量]

参数详情

参数	可选值	说明
prompt	任意文本	图片描述，建议英文效果更好
model	image-01（默认）	使用的模型
aspect_ratio	1:1, 16:9, 9:16, 4:3, 3:4	图片宽高比
quality	standard（默认）, premium	图片质量

使用示例

例 1：生成风景图

复制代码

生成一张日出时分的海边风景图，宽高比 16:9

例 2：生成人物图

复制代码

生成一张穿着汉服的中国古典美女肖像，比例 3:4

例 3：使用高质量模式

复制代码

用 premium 质量生成一张未来城市的高清图片

例 4：生成新年主题

复制代码

生成一张中国新年庆祝场景的图片，包含红灯笼、烟花、鞭炮等元素

获取图片文件

生成的图片是 base64 格式。如果需要保存为文件查看：

使用 Claude Code 的 Read 工具 直接让 Claude 读取生成的图片：

复制代码

读取生成的那张图片

使用命令行保存

bash 复制代码

# Windows PowerShell
node -e "
$json = Get-Content '路径/to/result.json' -Raw | ConvertFrom-Json
[System.IO.File]::WriteAllBytes('D:/output.png', [System.Convert]::FromBase64String($json[1].text))
"

# 或使用 Node.js 脚本（见下方）

使用 Python 脚本保存

python 复制代码

import base64
import json

with open('result.json', 'r') as f:
    data = json.load(f)

image_data = data[1]['text']
with open('output.png', 'wb') as f:
    f.write(base64.b64decode(image_data))

常见问题

Q1：提示 "No MCP servers configured"

原因：配置文件未正确保存或格式错误。

解决方法：

确认 ~/.claude.json 是有效的 JSON 格式
重启 Claude Code
运行 /doctor 检查错误

Q2：提示 "未设置 MINIMAX_API_KEY"

原因：环境变量或配置文件中的 API Key 未设置或错误。

解决方法：

确认 API Key 正确无误
确认配置文件中的 env 字段正确设置
检查是否有空格或引号错误

Q3：API 调用成功但图片模糊

原因：描述不够详细，或质量设置较低。

解决方法：

使用更详细的英文描述
将 quality 设置为 "premium"
尝试不同的 aspect_ratio

Q4：图片生成失败

可能原因：

API Key 过期或无效
网络连接问题
API 配额用尽

解决方法：

检查 API Key 是否正确
检查网络连接
登录 MiniMax 控制台检查配额

Q5：配置文件格式错误

原因：JSON 格式要求严格，缺少逗号、引号等。

解决方法：使用 JSON 验证工具检查格式，例如：

JSON Validator
VS Code 内置的 JSON 验证

Q6：路径错误（Windows）

问题：Windows 路径使用反斜杠 \，可能导致问题。

解决：在配置中使用正斜杠 /：

json 复制代码

"args": ["D:/MCP/minimax-image-mcp/build/index.js"]

快速参考

完整配置示例

~/.claude.json 文件中的 mcpServers 部分：

json 复制代码

"mcpServers": {
  "minimax-image": {
    "command": "node",
    "args": ["D:/MCP/minimax-image-mcp/build/index.js"],
    "env": {
      "MINIMAX_API_KEY": "sk-cp-xxxxxxxxxxxx"
    }
  }
}

常用命令

bash 复制代码

# 安装依赖
npm install

# 构建项目
npm run build

# 启动服务（测试用）
npm start

技术支持

如果遇到其他问题：

查看 MiniMax API 文档
查看 Claude Code MCP 文档
检查项目的 [GitHub Issues](/issues)