@trustao/qwen-image-edit-mcp

将阿里云百炼 千问图像编辑 API 封装为 MCP 服务，可通过 npx 一键接入 Cursor / Claude Desktop 等客户端。

支持：修改图内文字、增删或移动物体、改变主体动作、风格迁移、画面细节增强、多图融合（1–3 张输入，最多 6 张输出）。

快速配置（npx）

Cursor

在 MCP 设置中添加：

{
  "mcpServers": {
    "qwen-image-edit": {
      "command": "npx",
      "args": ["-y", "@trustao/qwen-image-edit-mcp"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key"
      }
    }
  }
}

推荐同时配置业务空间 ID（使用专属域名，更稳定）：

{
  "mcpServers": {
    "qwen-image-edit": {
      "command": "npx",
      "args": ["-y", "@trustao/qwen-image-edit-mcp"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key",
        "DASHSCOPE_WORKSPACE_ID": "your-workspace-id",
        "DASHSCOPE_REGION": "beijing"
      }
    }
  }
}

Claude Desktop

编辑 claude_desktop_config.json，写入同上 mcpServers 配置。

环境变量

| 变量 | 必填 | 说明 | | --- | --- | --- | | DASHSCOPE_API_KEY | 是 | 百炼 API Key。获取方式 | | DASHSCOPE_WORKSPACE_ID | 否 | 业务空间 ID，启用专属域名 | | DASHSCOPE_REGION | 否 | beijing（默认）或 singapore。两地 API Key 不可混用 | | DASHSCOPE_BASE_URL | 否 | 完全自定义 Base URL（覆盖地域/Workspace） | | QWEN_IMAGE_EDIT_MODEL | 否 | 默认模型，默认 qwen-image-2.0-pro |

提供的 Tools

edit_image

调用千问图像编辑模型。

| 参数 | 必填 | 说明 | | --- | --- | --- | | images | 是 | 1–3 张图：公网 URL / oss:// 临时 URL / Base64 data:image/...;base64,... | | prompt | 是 | 编辑指令（仅一条） | | model | 否 | 模型名，默认见环境变量 | | n | 否 | 输出张数 1–6（qwen-image-edit 仅支持 1） | | negative_prompt | 否 | 反向提示词 | | size | 否 | "宽*高"，如 "1024*1024"（qwen-image-edit 不支持） | | prompt_extend | 否 | 提示词智能改写，默认 API 侧为 true | | watermark | 否 | 是否加水印，默认 false | | seed | 否 | 随机种子 |

list_models

列出支持的模型与当前连接配置。

本地开发

npm install
npm run build
npm start

本地调试 MCP 配置示例：

{
  "mcpServers": {
    "qwen-image-edit": {
      "command": "node",
      "args": ["/absolute/path/to/qwenimgmcp/dist/index.js"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key"
      }
    }
  }
}

或使用未发布包：

{
  "mcpServers": {
    "qwen-image-edit": {
      "command": "npx",
      "args": ["-y", "/absolute/path/to/qwenimgmcp"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key"
      }
    }
  }
}

调用示例

单图编辑：

请用 edit_image：
- images: ["https://example.com/photo.png"]
- prompt: 把天空改成晚霞，保持人物不变
- model: qwen-image-2.0-pro
- size: 1024*1024

多图融合：

请用 edit_image：
- images: ["https://.../city.png", "https://.../character.png"]
- prompt: 使用图一城市照片为底图，将图二卡通形象放在建筑物周围…

注意事项

• 输出图像 URL 约 24 小时有效，请及时下载保存。
• 北京与新加坡地域的 API Key、请求地址相互独立，不可跨地域调用。
• 输入图建议宽高在 384–3072 像素，单张不超过 10MB。
• 官方文档：千问图像编辑

License

MIT