How do I use qwen-image-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@qwen-image-mcp generate an image of a serene mountain lake at sunset" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

qwen-image-mcp

by yingcaihuang

Overview Schema Related Servers Score Discussions

JavaScript

Remote

Qwen-Image MCP Server

中文文档

An MCP Server for Alibaba Cloud DashScope (Bailian) Qwen-Image (千问文生图) models, supporting both synchronous and asynchronous image generation. Defaults to sync mode (generate_image_sync) for the simplest one-shot workflow.

Gallery

The following images were generated using the ian-xiaohei-illustrations Skills combined with this MCP Server (Qwen text-to-image):

Related MCP server: Seedream 4.0 MCP Server

Features

Tools

Tool	Description	Supported Models
`generate_image_sync`	Qwen text-to-image - Sync generation (one request, direct result, default mode) ✅ Recommended	qwen-image-2.0-pro, qwen-image-2.0, qwen-image-max
`generate_image_async`	Qwen text-to-image - Async generation (submit task, returns task_id, poll for result)	qwen-image-plus, qwen-image
`check_task_status`	Check async task status (use with generate_image_async)	-
`download_image`	Download generated images locally (call after task completes)	-

Supported Models

Model	Mode	Resolution	Features
`qwen-image-2.0-pro`	Sync	512×512 ~ 2048×2048	Best text rendering & realism
`qwen-image-2.0`	Sync	Same as above	Balanced speed & quality
`qwen-image-max`	Sync	Fixed options	High realism, low AI artifacts
`qwen-image-plus`	Async	Fixed options	Diverse artistic styles
`qwen-image`	Async	Fixed options	Basic version

Environment Variables

Variable	Default	Description
`DASHSCOPE_API_KEY`	`example-key`	Required. Alibaba Cloud DashScope API Key
`DASHSCOPE_BASE_URL`	`https://dashscope.aliyuncs.com/api/v1`	API base URL
`SYNC_MODEL`	`qwen-image-2.0-pro`	Model for sync generation
`ASYNC_MODEL`	`qwen-image-plus`	Model for async generation
`SAVE_DIR`	`~/Desktop/qwen-images`	Image save directory. ⚠️ For Amazon Q Desktop: you must add this path in Settings → My computer → Local folders, otherwise the sandbox has no permission to read/write
`WORK_DIR`	`process.cwd()`	Working directory

Quick Start

1. Install Dependencies

npm install

2. Build

npm run build

3. Configure MCP Client

Add configuration in your MCP client (Claude Desktop, Kiro, etc.):

{
  "mcpServers": {
    "qwen-image": {
      "command": "node",
      "args": ["/path/to/qwen-image-mcp/build/index.js"],
      "env": {
        "DASHSCOPE_API_KEY": "sk-your-api-key",
        "DASHSCOPE_BASE_URL": "https://your-workspace.cn-beijing.maas.aliyuncs.com/api/v1",
        "SYNC_MODEL": "qwen-image-2.0-pro",
        "SAVE_DIR": "/Users/yourname/Pictures/qwen-images"
      }
    }
  }
}

Usage Examples

Sync Generation (Recommended)

Call generate_image_sync:

prompt: "A ginger cat napping in the sunshine"
size: "2048*2048"
prompt_extend: true

Returns image URL directly and auto-downloads to local disk.

Async Generation

Call generate_image_async to get task_id
Poll check_task_status every 10 seconds
Once completed, call download_image to save images

API Reference

Sync Parameters

Parameter	Type	Required	Description
prompt	string	✅	Image prompt
negative_prompt	string	-	Negative prompt
size	string	-	Resolution, default 2048*2048
n	number	-	Number of images (1-6), default 1
seed	number	-	Random seed
prompt_extend	boolean	-	Smart rewriting, default true
watermark	boolean	-	Watermark, default false
model	string	-	Model name

Async Parameters

Parameter	Type	Required	Description
prompt	string	✅	Image prompt
negative_prompt	string	-	Negative prompt
size	string	-	Resolution, default 1664*928
seed	number	-	Random seed
prompt_extend	boolean	-	Smart rewriting, default true
watermark	boolean	-	Watermark, default false
model	string	-	Model name

Debugging

npm run inspector

Notes

Image URLs expire after 24 hours; download promptly
qwen-image-2.0 series supports sync mode only
qwen-image-plus / qwen-image supports async mode only
Amazon Q Desktop users: Q Desktop runs MCP Servers in a sandboxed environment with no default filesystem access. You must configure SAVE_DIR as an allowed path in Settings → My computer → Local folders before images can be saved

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/yingcaihuang/qwen-image-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server