listing-image-mcp
商品生图 MCP 服务。产出商品主图组（多图类型）+ 详情页图，供智能体在「视觉生成」环节调用。
每张生成图都带 ai_generated=True 元信息（合规：AI 生成内容标识）。
工具
generate_image(prompt, reference_image_urls, size, count, watermark, output_format) —— 统一生图入口：
| 模式 | 触发 | 说明 |
|---|---|---|
| 文生图 | reference_image_urls 为空 | 纯文本生成 |
| 单图生图 | 1 张参考图 | 实物图保商品一致 |
| 多图生图 | 2-14 张参考图 | 多张实物图 + 可选爆款构图参考 |
| 组图 | count>1 | 一次生成一组内容关联、风格统一的图 |
后端（可插拔）
mock（默认）—— 零密钥本地占位图，串流程联调用。seedream—— 字节系 Seedream 5.0 lite（火山方舟）。
启动（STDIO MCP）
uvx listing-image-mcp
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
IMAGE_BACKEND |
否 | mock（默认）/ seedream |
ARK_API_KEY |
seedream 时 | 火山方舟 API Key |
ARK_BASE_URL |
否 | 默认 https://ark.cn-beijing.volces.com/api/v3 |
ARK_MODEL |
否 | 默认 doubao-seedream-5-0-lite-260128 |
IMAGE_OUTPUT_DIR |
否 | 生成图保存目录，默认 ~/.listing_image_mcp/generated |
IMAGE_MAIN_SIZE |
否 | 主图默认尺寸，默认 2048x2048 |
IMAGE_DETAIL_SIZE |
否 | 详情页默认尺寸，默认 1920x2560 |
Seedream 5.0 lite 已核实要点
- 端点：
POST {ARK_BASE_URL}/images/generations - 模型：
doubao-seedream-5-0-lite-260128 - 参考图：
image字段，单字符串或字符串数组（2-14 张）；接受 URL / base64 data URL / 本地路径（自动转 base64） - 组图：
sequential_image_generation = "auto" - 尺寸：最小 3,686,400 像素（1920x1920），更小会 400，本包自动抬升
- 水印：
watermark=false即无平台水印
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file listing_image_mcp-0.1.0.tar.gz.
File metadata
- Download URL: listing_image_mcp-0.1.0.tar.gz
- Upload date:
- Size: 6.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4bab1075b37371c37a5e9253da8047d860377c6a40a9c7da173f880b90fc4bcc
|
|
| MD5 |
11b629c2fa14a66bfaac681b0dad1cc3
|
|
| BLAKE2b-256 |
f6f7b2d63bffceb711e0ede1448c208c148cf67189cc63d8ec0bcda7d0c632a5
|
File details
Details for the file listing_image_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: listing_image_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2edef3711168740a9633c041e70e00f0f32bb4f4e3dfb8585b0facdd7bb40ff7
|
|
| MD5 |
f19e69afb3a21b13442f9a69977b6e7a
|
|
| BLAKE2b-256 |
b87f705ef30ac5eeea19381ca4910f8beb6d4a20b42a43cfd6f3f017b724aa51
|
