qwen-image-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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 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 |
| 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 |
| Qwen text-to-image - Async generation (submit task, returns task_id, poll for result) | qwen-image-plus, qwen-image |
| Check async task status (use with generate_image_async) | - |
| Download generated images locally (call after task completes) | - |
Supported Models
Model | Mode | Resolution | Features |
| Sync | 512×512 ~ 2048×2048 | Best text rendering & realism |
| Sync | Same as above | Balanced speed & quality |
| Sync | Fixed options | High realism, low AI artifacts |
| Async | Fixed options | Diverse artistic styles |
| Async | Fixed options | Basic version |
Environment Variables
Variable | Default | Description |
|
| Required. Alibaba Cloud DashScope API Key |
|
| API base URL |
|
| Model for sync generation |
|
| Model for async generation |
|
| 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 |
|
| Working directory |
Quick Start
1. Install Dependencies
npm install2. Build
npm run build3. 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_asyncto gettask_idPoll
check_task_statusevery 10 secondsOnce completed, call
download_imageto 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 inspectorNotes
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_DIRas an allowed path in Settings → My computer → Local folders before images can be saved
License
MIT
Available Tools
4 toolscheck_task_statusA
Check async image generation task status.
Inputs: task_id (required).
download_imageB
Download images from a completed async task.
Inputs: task_id (required), save_path.
generate_image_asyncA
Submit async image generation task (qwen-image-plus, qwen-image). Returns task_id for polling.
Inputs: prompt (required), seed, size, model, +3 more.
generate_image_syncA
Generate images synchronously using Qwen-Image 2.0 series (qwen-image-2.0-pro, qwen-image-2.0, qwen-image-max). One request returns result directly.
Inputs: prompt (required), n, seed, size, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a unique, clearly distinct purpose: synchronous generation, async submission, status checking, and download. No functional overlap exists.
All tool names follow a consistent verb_noun pattern (generate_image_*, check_task_status, download_image), making them predictable and easy to understand.
Four tools perfectly cover the core image generation workflow (sync, async, polling, download) without excess or deficiency.
Core generation workflow is fully covered (sync, async, status, download). Minor gaps like task cancellation or listing are absent but not critical for basic usage.
Maintenance
Related MCP Connectors
Generate images and videos with Kling AI Global via OAuth. Generation uses account credits.
Create images and videos from prompts, with options for image mixing, reference images, and start/…
Generate images and videos (GPT Image, Seedance, Kling, Wan, Qwen) with one API key.
Generate images, videos and music with model discovery, cost estimates and asynchronous results.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables users to generate high-quality images using ModelScope's Qwen-Image model through natural language prompts. Supports async task processing with both image URL and base64 encoded data output options.12MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI image generation using Volcano Engine's Seedream 4.0 API with text-to-image, image-to-image, multi-image fusion capabilities, built-in prompt templates, and automatic cloud storage integration.19MIT
- AlicenseBqualityDmaintenanceEnables AI-powered text-to-image generation using Volcengine's API with support for multiple image sizes, customizable parameters like guidance scale and seed, and flexible output formats.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered image generation using Volcano Engine's SeeDream 4.0 model. Supports custom sizes, reference images, and automatic prompt generation without complex prompting.7 npmMIT