Qwen Image 3.0 MCP Server

基于阿里云百炼 DashScope API 的千问图像生成与编辑 MCP 服务，提供文生图（T2I）和图生图/图像编辑（I2I）能力。

功能

模型选择

前提条件

1. 阿里云百炼 API Key — 获取地址
2. Python >= 3.10
3. uv（推荐）— 安装指引

安装

# 克隆项目
git clone <repo-url> qwen-image-mcp
cd qwen-image-mcp

# 安装依赖
uv sync

配置

创建 .env 文件（参考 .env.example）：

# 必填：阿里云百炼 API Key
DASHSCOPE_API_KEY=sk-xxxxxxxxxxxx

# 可选：业务空间 ID（推荐，性能更优）
WORKSPACE_ID=

# 可选：地域（默认 cn-beijing）
REGION=cn-beijing

或直接通过环境变量传入。

使用方式

方式一：uvx（推荐）

uvx --from <项目路径> qwen-image-mcp

方式二：uv run

uv run qwen-image-mcp

方式三：MCP 客户端配置

在 Claude Code 的 settings.json 中添加：

{
  "mcpServers": {
    "qwen-image": {
      "command": "uvx",
      "args": ["--from", "/path/to/qwen-image", "qwen-image-mcp"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-你的key",
        "WORKSPACE_ID": "",
        "REGION": "cn-beijing"
      }
    }
  }
}

工具参考

generate_image — 文生图

edit_image — 图生图/图像编辑

图像输入格式

• 公网 URL：https://example.com/image.png
• Base64 编码：data:image/png;base64,iVBORw0KGgo...
• 支持格式：JPG、JPEG、PNG、BMP、TIFF、WEBP、GIF
• 单张不超过 10MB，分辨率建议 384-2048 像素

环境变量

示例

文生图 — 生成一张风景照

prompt: "一幅秋日山间晨雾的风景摄影，暖金色阳光穿透薄雾，远山层叠，前景有金黄色的落叶松林"

图生图 — 人物换装

images: ["https://example.com/portrait.jpg"]
prompt: "保留人物面部特征，将服装换为深蓝色商务西装，背景改为现代办公室"

图生图 — 风格转换

images: ["https://example.com/photo.jpg"]
prompt: "将这张照片转换为宫崎骏动画风格，保持构图不变"

响应格式

成功返回的图像 URL 有效期为 24 小时，请及时下载保存。

✅ 文生图完成

**图像 1**
- URL（24h 有效）: https://dashscope-result-sz.oss-cn-shenzhen.aliyuncs.com/xxx.png

分辨率: 1024×1024
生成数量: 1
输入图片数: 0
request_id: 571ae02f-5c9d-436c-83c2-f221e6df0xxx

技术栈

• Python 3.10+
• MCP Python SDK 2.0+
• httpx
• uv — 包管理与构建

许可证

MIT