即梦图像/视频生成MCP
基于火山引擎 Jimeng 视觉生成 API 的 MCP 服务器,通过模型上下文协议(MCP)提供图像和视频生成功能。支持文本生成图像、图像到图像、多图融合、文本生成视频以及图像到视频等功能,并且自动支持本地文件。
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"jimeng_visual_generation": {
"args": [
"jimeng_visual_generation"
],
"command": "uvx",
"env": {
"VOLC_API_KEY": "your_volcengine_api_key_here",
"VOLC_IMAGE_MODEL": "doubao-seedream-4.5",
"VOLC_VIDEO_MODEL": "doubao-seedance-1.5-pro-251215"
}
}
}
}
该服务需要配置环境变量:VOLC_API_KEY、VOLC_IMAGE_MODEL、VOLC_VIDEO_MODEL
可用工具 (3 个)
该服务在 MCP 协议中暴露的工具,AI 可按需调用
generate_image 1 个参数 需填 1 项
Generate images using the Volcengine (Jimeng) API. Capabilities: 1. **Text-to-Image (T2I)**: Provide only `prompt`. 2. **Image-to-Image (I2I)**: Provide `prompt` and one reference image in `image_urls`. 3. **Multi-Image Fusion**: Provide `prompt` and multiple reference images in `image_urls` (only supported by specific models like seedream-4.5). Image Input Format: - **URL**: A publicly accessible HTTP/HTTPS URL. - **Base64**: A data URI string, e.g., `data:image/jpeg;base64,...`. - **Local Path**: Absolute path to a local image file (e.g., `E:/photos/test.jpg`). The server will automatically convert it.
必填参数:params
generate_video 1 个参数 需填 1 项
Create a video generation task. Supports Text-to-Video and Image-to-Video. Modes (Automatically detected based on `image_urls`): 1. **Text-to-Video**: Leave `image_urls` empty. 2. **First Frame I2V**: Provide exactly 1 image. The video will start with this image. 3. **First & Last Frame I2V**: Provide exactly 2 images. The video will generate a transition from the first to the second image. You can provide local file paths (e.g., "C:/images/start.jpg"), and they will be automatically converted to Base64 for the API. Returns: - A **Task ID** string. You must use `get_video_task_result` to query the actual video URL after some time.
必填参数:params
get_video_task_result 1 个参数 需填 1 项
Query the status and result of a video generation task. Usage: - Call this periodically after submitting a video task. - Status values: 'queued', 'running', 'succeeded', 'failed'. - If 'succeeded', returns the final Video URL.
必填参数:params
服务介绍
Jimeng 视觉生成 MCP 服务器
基于 Volcengine(火山引擎)Jimeng 视觉生成 API 的 MCP 服务器。通过模型上下文协议(MCP)提供图像和视频生成功能。
功能
- 文本生成图像(T2I):根据文本提示生成图像
- 图像到图像(I2I):基于提示和参考图像对图像进行变换
- 多图融合:合成多张参考图像
- 文本生成视频(T2V):根据文本提示生成视频
- 图像到视频(I2V):从首帧或首帧+末帧图像生成视频
- 自动本地文件支持:可传入图像公网URL,同时支持本地文件路径,程序会自动将其转换为 Base64
安装
选项 1:通过 pip 安装
pip install jimeng_visual_generation
选项 2:直接使用 uvx 运行(推荐)
无需安装。uvx 会自动下载并运行该包:
uvx jimeng_visual_generation
在 VS Code / Cursor / Claude Desktop 中的配置
将下列内容添加到你的 MCP 配置文件:
- VS Code:
~/.vscode/mcp.json或 工作区设置 - Cursor:Settings -> MCP Servers
- Claude Desktop:
%APPDATA%\Claude\claude_desktop_config.json
示例配置(使用环境变量)
{
"mcpServers": {
"jimeng_visual_generation": {
"command": "uvx",
"args": ["jimeng_visual_generation"],
"env": {
"VOLC_API_KEY": "your_volcengine_api_key_here",
"VOLC_IMAGE_MODEL": "doubao-seedream-4.5",
"VOLC_VIDEO_MODEL": "doubao-seedance-1.5-pro-251215"
}
}
}
}
环境变量
| 变量 | 是否必需 | 描述 |
|---|---|---|
VOLC_API_KEY |
✅ 必需 | 你的 Volcengine API Key |
VOLC_IMAGE_MODEL |
可选 | 图像模型 ID(默认:doubao-seedream-4.5) |
VOLC_VIDEO_MODEL |
可选 | 视频模型 ID(默认:doubao-seedance-1.5-pro) |
可用工具
generate_image
使用文本提示和可选参考图像生成图像。
参数:
prompt(必需):描述目标图像的文本image_urls(可选):参考图像列表(支持 URL、Base64 或本地文件路径)model(可选):使用的模型 IDsize(可选):图像尺寸(例如:"2048x2048"、"2K"、"4K")
generate_video
创建视频生成任务。根据输入自动判断模式:
- 无图像 → 文本生成视频(T2V)
- 1 张图像 → 首帧 I2V
- 2 张图像 → 首帧 & 末帧 I2V
参数:
prompt(可选):视频描述的文本image_urls(可选):输入图像(支持 URL、Base64 或本地文件路径)model(可选):使用的模型 IDratio(可选):宽高比(例如:"16:9"、"9:16")duration(可选):视频时长(秒)
get_video_task_result
查询视频生成任务的状态和结果。
参数:
task_id(必需):由generate_video返回的任务 ID
📄 开源协议 (License)
本项目基于 MIT License 开源。
💖 赞助 (Sponsorship)
维护开源项目不易,如果您觉得 jimeng_visual_generation 对您有帮助,欢迎请作者喝杯咖啡!
| 平台 | 链接 | 支付方式 |
|---|---|---|
| 爱发电 (Afdian) | 微信, 支付宝 |