jimeng-ai-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., "@jimeng-ai-mcp Generate a 10-second video of a fox running in snow, 16:9"
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.
jimeng-mcp
即梦 AI 的 MCP 服务 — 让 Claude、Cursor 等 AI 助手直接调用即梦的图片/视频生成能力。
English | 中文
这是什么
MCP(Model Context Protocol) 是 Anthropic 推出的开放协议,允许 AI 模型通过标准化接口调用外部工具和服务。
jimeng-mcp 将字节跳动旗下即梦 AI 的官方 Volcengine API 封装为 MCP 服务。接入后,你可以在 Claude、Cursor 等支持 MCP 的客户端里,用自然语言直接驱动即梦生成图片和视频——无需打开浏览器,无需手动上传,生成结果自动保存到本地。
Related MCP server: Jimeng AI Multimodal MCP
能做什么
图片能力
工具 | 能力 | 底层模型 |
| 文生图,支持 4.0 / 4.6 / 3.x 多模型 | 即梦图片系列 |
| 图生图,智能参考原图风格/内容进行编辑 | jimeng_i2i 3.0 |
| 局部重绘:涂抹修改或消除画面元素 | inpaint |
| 智能超清:低清图片放大到 4K / 8K | Seedream SR |
视频能力
工具 | 能力 | 底层模型 |
| 文生视频,720P / 1080P / Pro 三档 | 即梦视频 3.0 |
| 图生视频:首帧、首尾帧、重新运镜、Pro 模式 | 即梦视频 3.0 |
| 动作模仿:将参考视频的动作迁移到目标人物 | DreamActor 2.0 |
| 数字人:图片 + 音频 → 口型同步说话视频 | OmniHuman 1.5 |
| 视频翻译:保留音色,口型同步换语言 | 翻译 2.0 |
使用场景
内容创作者:对话式生成配图和视频素材,不切换工具
产品/设计:在 Cursor 里边改需求文档边生成原型图
营销团队:批量生成不同风格的创意图,描述即出图
开发者:在自己的 AI 应用中集成即梦能力,无需关心鉴权细节
快速上手
第一步:开通服务
登录火山引擎控制台,开通即梦 AI 服务
在访问控制 → API 访问密钥获取 Access Key ID 和 Secret Access Key
第二步:安装
推荐使用 uvx(无需手动安装,运行时自动拉取):
uvx jimeng-ai-mcp也可以用 pip 全局安装:
pip install jimeng-ai-mcp第三步:配置 MCP 客户端
Claude Desktop
配置文件路径:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"jimeng": {
"command": "uvx",
"args": ["jimeng-ai-mcp"],
"env": {
"JIMENG_ACCESS_KEY_ID": "填入你的 Access Key ID",
"JIMENG_SECRET_ACCESS_KEY": "填入你的 Secret Access Key"
}
}
}
}Cursor
配置文件路径:~/.cursor/mcp.json
{
"mcpServers": {
"jimeng": {
"command": "uvx",
"args": ["jimeng-ai-mcp"],
"env": {
"JIMENG_ACCESS_KEY_ID": "填入你的 Access Key ID",
"JIMENG_SECRET_ACCESS_KEY": "填入你的 Secret Access Key"
}
}
}
}重启客户端后,在对话框里直接输入指令即可,例如:"帮我生成一张赛博朋克风格的城市夜景图"
本地开发模式
git clone https://github.com/andyleimc-source/jimeng-ai-mcp
cd jimeng-mcp
cp .env.example .env
# 用编辑器打开 .env,填入两个密钥
uv sync
uv run jimeng-mcp本地调试(启动 MCP Inspector):
uv run mcp dev src/jimeng_mcp/server.py使用示例
以下是在 Claude Desktop 中的实际对话示例:
文生图
帮我生成一张宋代山水画风格的图片,16:9 横幅,用即梦 4.0 模型
图生图
把这张产品图的背景换成简洁的白色摄影棚风格,保留产品主体不变 [附上图片 URL]
文生视频
生成一段 10 秒的视频:一只狐狸在雪地里奔跑,慢镜头,电影感,16:9
图生视频(首尾帧)
我有两张图,帮我生成首尾帧驱动的视频,开头是这张日出照片,结尾是这张夕阳照片,5 秒 首帧:[URL1],尾帧:[URL2]
数字人
用这张人物图片和这段音频,生成一个口型同步的数字人视频,输出 1080P 图片:[URL],音频:[URL]
视频翻译
把这个中文视频翻译成英文,口型同步 [视频 URL]
工具参数速查
generate_image
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 图片描述 |
| string |
|
|
| string |
|
|
| string |
|
|
| string |
| 不希望出现的内容 |
generate_video
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 视频描述 |
| string |
|
|
| string |
|
|
| int |
|
|
image_to_video
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 首帧图片 URL |
| string | 必填 | 视频描述 |
| string |
|
|
| int |
|
|
| string |
| 尾帧图片( |
translate_video
参数 | 类型 | 默认值 | 说明 |
| string | 必填 | 原视频 URL |
| string | 必填 | 目标语言代码 |
| string |
| 源语言代码 |
语言代码:zh 中文 · en 英语 · ja 日语 · ko 韩语 · fr 法语 · de 德语 · es 西班牙语 · pt 葡萄牙语 · ru 俄语 · ar 阿拉伯语 · it 意大利语
环境变量
变量 | 必填 | 说明 |
| ✅ | 火山引擎 Access Key ID |
| ✅ | 火山引擎 Secret Access Key |
| 可选 | 生成文件保存目录,默认 |
相关资源
License
Available Tools
9 toolsgenerate_digital_humanA
数字人生成(OmniHuman 1.5):驱动人物图片口型和动作,配合音频生成说话视频。 使用模型:jimeng_realman_avatar_picture_omni_v15
portrait_url: 人物肖像图片 URL(含人物/动漫/宠物)
audio_url: 驱动音频 URL(WAV/MP3,必须小于 60 秒)
resolution: 输出分辨率,720 或 1080(默认 1080)
prompt: 可选提示词,支持中/英/日/韩语,最长 300 字符
注意:此接口使用 CVSubmitTask/CVGetResult(与普通接口不同)。
Inputs: audio_url (required), portrait_url (required), prompt, resolution. Returns: result
generate_imageA
文生图:根据文字描述生成图片。
model(模型版本):
jimeng_t2i_v40 图片生成 4.0(默认,推荐)
jimeng_seedream46_cvtob 图片生成 4.6(Seedream,支持最高 4K)
jimeng_t2i_v31 文生图 3.1
jimeng_t2i_v30 文生图 3.0
jimeng_high_aes_general_v21_L 通用高美感 v2.1
aspect_ratio: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3
quality: 2k(默认)/ normal
negative_prompt: 负面提示词(可选,部分模型不支持)
Inputs: prompt (required), model, quality, aspect_ratio, +1 more. Returns: result
generate_videoA
文生视频:根据文字描述生成视频(约需 1~5 分钟)。
model(模型版本):
jimeng_t2v_v30 视频生成 3.0 720P(默认)
jimeng_t2v_v30_1080p 视频生成 3.0 1080P
jimeng_ti2v_v30_pro 视频生成 3.0 Pro 1080P(效果更好)
aspect_ratio: 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9
duration_sec: 5(默认)或 10
Inputs: prompt (required), model, aspect_ratio, duration_sec. Returns: result
image_to_imageA
图生图(智能参考):参考输入图片,结合文字描述编辑或生成新图片。 使用即梦图生图 3.0 模型(jimeng_i2i_v30)。
image_url: 参考图片 URL(JPEG/PNG,最大 4.7MB,最大 4096×4096)
aspect_ratio: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3
quality: 2k(默认)/ normal
scale: 文本影响程度 0.0~1.0(默认 0.5,越大越贴近文字描述,越小越保留原图)
Inputs: prompt (required), image_url (required), scale, quality, +1 more. Returns: result
image_to_videoA
图生视频:将静态图片转换为动态视频(约需 1~5 分钟)。
image_url: 首帧图片 URL(JPEG/PNG,最大 4.7MB)
prompt: 视频内容描述(必填)
mode(模式):
first 首帧驱动 720P(默认)
first_1080p 首帧驱动 1080P
first_tail 首尾帧驱动 720P(需提供 tail_image_url)
first_tail_1080p 首尾帧驱动 1080P(需提供 tail_image_url)
recamera 重新运镜 720P(需提供 template_id,通过 prompt 描述运镜效果)
pro 视频生成 3.0 Pro 1080P(首帧,效果更好)
duration_sec: 5(默认)或 10
tail_image_url: 尾帧图片 URL(仅 first_tail / first_tail_1080p 模式需要)
recamera 模式可用运镜模板(在 prompt 中指定 template_id): hitchcock_dolly_in / hitchcock_dolly_out / robo_arm / dynamic_orbit / central_orbit / crane_push / quick_pull_back / counterclockwise_swivel / clockwise_swivel / handheld / rapid_push_pull
Inputs: prompt (required), image_url (required), mode, duration_sec, +1 more. Returns: result
imitate_motionA
动作模仿 2.0:提取参考视频中的动作/表情/口型,迁移到目标人物图片上。 使用模型:jimeng_dreamactor_m20_gen_video
image_url: 目标人物图片 URL(JPEG/PNG,480×480 以上,1920×1080 以内)
video_url: 动作参考视频 URL(MP4/MOV/WEBM,最长 30 秒)
输出视频约需 3~5 分钟(10 秒视频约需 180 秒)。
Inputs: image_url (required), video_url (required). Returns: result
inpaint_imageA
局部重绘(Inpainting):在图片的指定区域(mask)内根据提示词重新生成内容。 使用即梦交互编辑模型(jimeng_image2image_dream_inpaint)。
image_url: 原图 URL(JPEG/PNG,最大 4.7MB)
mask_url: 遮罩图 URL(单通道灰度图,白色=重绘区域,黑色=保留区域)
prompt: 重绘内容描述;输入"删除"可消除选区内容
Inputs: prompt (required), mask_url (required), image_url (required). Returns: result
translate_videoA
视频翻译 2.0:将视频中的语音翻译并口型同步为目标语言。 使用模型:video_translate_v2_cvtob
video_url: 原始视频 URL(需公网可访问)
target_language: 目标语言缩写
src_language: 源语言缩写(默认 "zh" 中文)
支持的语言代码: zh(中文)en(英语)ja(日语)ko(韩语)fr(法语)de(德语) es(西班牙语)pt(葡萄牙语)ru(俄语)ar(阿拉伯语)it(意大利语) hi(印地语)id(印尼语)nl(荷兰语)tr(土耳其语)pl(波兰语)等
Inputs: video_url (required), target_language (required), src_language. Returns: result
upscale_imageA
智能超清:将图片放大并增强细节至 4K 或 8K 分辨率。 使用即梦智能超清模型(jimeng_i2i_seed3_tilesr_cvtob)。
image_url: 输入图片 URL(JPEG/PNG,最大 4.7MB,最大 4096×4096)
resolution: "4k"(默认)或 "8k"
detail: 细节生成程度 0~100(默认 50,越大细节越多但可能偏离原图)
Inputs: image_url (required), detail, resolution. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct media generation or editing task: text-to-image, image-to-image, inpainting, upscaling, text-to-video, image-to-video, motion imitation, digital human creation, and video translation. There is no meaningful overlap between these operations.
All tool names use a consistent lowercase_snake_case convention with a clear verb_noun or transformation pattern (generate_image, inpaint_image, image_to_video, translate_video). The two image_to_* names follow a predictable transformation pattern, making the set uniform and intuitive.
With 9 tools, the server is well-scoped for an AI media generation platform. Each tool covers a distinct capability without redundancy, and the count falls comfortably within the ideal 3-15 range.
The tool surface covers the core media generation lifecycle: image creation/editing/upscaling, video generation from text or images, motion transfer, digital humans, and video translation. Minor gaps like audio generation or task management are not critical for the stated purpose, but the set is quite comprehensive.
Maintenance
Related MCP Connectors
Image and video AI tools and your own pipelines, run from any AI assistant.
LLM chat, text tools, image generation, editing, batch image jobs, and asynchronous video generation
Create images and videos from prompts, with options for image mixing, reference images, and start/…
Create AI images and videos, manage projects and credits, and use workspace campaign context.
Related MCP Servers
- AlicenseDqualityDmaintenanceIntegrates Jimeng AI image and video generation services through MCP protocol, enabling users to generate high-quality images and videos from text prompts with support for image mixing, reference images, and multiple AI models.329 npm53MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered multimodal content generation using Volcano Engine's Jimeng AI, supporting text-to-image, text-to-video, and image-to-video conversion with customizable parameters.42 npm30MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to generate images and videos through natural language using ImaginePro's API. Supports text-to-image generation, video creation, image upscaling, variants, inpainting, and multi-modal generation with real-time progress tracking.812 npmMIT
- FlicenseAqualityCmaintenanceEnables AI assistants to generate images and videos via the Agnes AI API, supporting text-to-image, image-to-image, and video generation.31-