generate_imageLABSCO SUMMARY
Prompt in, file on disk.
Most image tools hand back a link you then have to download. This one takes the folder you name and writes the picture there, so the result of the call is a file you can already open.
What it is
An image generator wired to Volcengine's Doubao Seedream model. You give it a prompt, a filename, a destination folder and an aspect ratio; what comes back is a picture already saved to disk rather than a link you then have to fetch.
What you get
- Text-to-image generation from a prompt written in Chinese or in English
- Square, landscape and portrait shapes — 1:1, 4:3, 16:9, 3:4 and 9:16 — chosen per call rather than fixed at setup
- The file written into a folder you name, with the path and its permissions checked before generation starts
- Retries on a failed model call, and a specific message when it still fails
Requirements
Python 3.10 or newer with uv, and a Volcengine Ark API key from console.volcengine.com. The key goes in your shell environment; the server runs locally and writes into whatever folder the call points it at. One image per call — the model does not batch.
Setup effort
Build from source — git clone https://github.com/chenyeju295/mcp_generate_images.git
USE CASES
01
Illustrating a document you are already writing
Ask for the picture and name the folder your draft lives in — the file lands next to it, with no download step in between.
02
Getting an image at the shape you actually need
Choose the ratio per call — 16:9 for a slide, 9:16 for a phone screen — rather than cropping a square afterwards.
03
Working from Chinese prompts
Chinese prompts go straight to the Doubao model, so nothing is lost to a translation step first.
04
Building up a folder of related images
Each call carries its own filename and destination, so a set of images is named and filed as it is made.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
- Python 3.10+
- ARK_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/chenyeju295/mcp_generate_images.git
cd mcp_generate_images
python3 -m pip install fastmcp requests 'volcengine-python-sdk[ark]'MCP Clients
Cursor
CURSOR · JSON
{
"mcpServers": {
"generate_images": {
"command": "uv",
"args": [
"run",
"--with",
"fastmcp",
"fastmcp",
"run",
"/Users/<YOUR_USERNAME>/Documents/mcp_generate_images/mcp_server.py"
]
}
}
}The configuration on this page does not set ARK_API_KEY; the project's instructions set it with an export line. That line reaches only programs started from the same terminal, so to supply ARK_API_KEY, start your client or the server from that terminal.
