MiniMax 文生图 MCP Server

• 提供 MCP 工具 minimax_generate_image，调用 MiniMax 文生图接口并将生成的图片保存到本地指定目录。
• 使用 Node.js 开发，通过启动参数传入【图片保存路径】【token】。

安装依赖

1. 在项目根目录执行：npm install
2. 需要 Node.js 18+（以使用内置 fetch）。

启动（独立运行/调试）

• 命令：node src/server.js --outputDir <保存目录> --token <你的MiniMaxToken>
• 示例：node src/server.js --outputDir ./outputs --token sk-xxxx

使用 npx 启动

• 在项目根目录执行（本地开发未发布场景）：
  • npx -y . -- --outputDir ./outputs --token sk-xxxx
• 安装后也可直接（如果发布到 npm，或全局安装）：
  • npx @airtrioa/max-image-mcp --outputDir ./outputs --token sk-xxxx

npm 发布步骤

• 检查包名是否可用：npm search max-image-mcp
• 登录 npm：npm login
• 发布公开包：npm publish --access public
• 验证使用：npx @airtrioa/max-image-mcp --outputDir ./outputs --token sk-xxxx
• 如包名冲突，可使用作用域发布：
  • 修改 package.json 的 name 为 @你的作用域/max-image-mcp
  • 发布：npm publish --access public
  • 使用：npx @你的作用域/max-image-mcp --outputDir ./outputs --token sk-xxxx

MCP 工具说明

• 名称：minimax_generate_image
• 描述：根据文本生成图片（MiniMax），并保存到启动参数指定目录
• 入参：
  • prompt：string，必填
  • aspect_ratio：1:1 | 16:9 | 9:16 | 4:3 | 3:4，可选，默认 16:9
  • model：string，可选，默认 image-01
  • filename_prefix：string，可选，默认 minimax
  • count：number，可选，默认 1
• 返回：
  • text：生成并保存的图片数量
  • json：{ files: string[] } 保存的绝对路径列表

Claude Desktop 配置示例

在 Claude Desktop 的 mcp/settings.json 中添加：

{
  "servers": {
    "minimax-image-mcp": {
      "command": "node",
      "args": [
        "e:/liuzw-code/max-image-mcp/src/server.js",
        "--outputDir",
        "e:/liuzw-code/max-image-mcp/outputs",
        "--token",
        "<你的MiniMaxToken>"
        
      ]
    }
  }
}

参考

• MiniMax 文生图接口：https://api.minimaxi.com/v1/image_generation（Authorization: Bearer <token>）。
• 请求体关键字段：model, prompt, aspect_ratio, response_format: 'base64'。
• 响应字段：data.image_base64: string[]。