jimeng-video-mcp-server
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-video-mcp-server Generate a 5-second video from this image of a sunset with clouds moving."
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 Video MCP Server (即梦视频3.0 图生视频)
一个用于在 Cursor 中调用即梦视频 3.0 图生视频(首帧)API 的 MCP 服务器。
功能
图生视频(首帧模式): 提供一张首帧图片 + 文字描述,生成 720P 视频
5s / 10s 时长: 支持 121 帧(5秒)或 241 帧(10秒)
中英文 Prompt: 支持中英文混合描述
可复现: 通过 seed 参数可复现相同视频
Related MCP server: Jimeng MCP Server
安装
常规安装(海外环境)
cd jimeng-video-mcp-server
npm install
npm run build国内环境安装(解决 SSL 证书/网络问题)
如果在国内使用时遇到 SSL 证书错误、安装缓慢或连接超时问题,请使用以下命令:
cd jimeng-video-mcp-server
npm install --registry=https://registry.npmmirror.com --verbose --unsafe-perm --strict-ssl=false
npm run build配置 Cursor
在 Cursor 的 MCP 设置中(Settings → MCP → Add new MCP server)添加:
{
"mcpServers": {
"jimeng-video": {
"command": "node",
"args": ["/你的绝对路径/jimeng-video-mcp-server/dist/index.js"],
"env": {
"VOLC_ACCESS_KEY_ID": "你的AccessKeyID",
"VOLC_SECRET_ACCESS_KEY": "你的SecretAccessKey",
"NODE_TLS_REJECT_UNAUTHORIZED": "0"
}
}
}
}⚠️ 将路径替换为实际路径。
NODE_TLS_REJECT_UNAUTHORIZED仅在有代理/VPN 时需要。
提供的工具
1. jimeng_generate_video
提交视频生成任务,返回 task_id。需要手动查询结果。
2. jimeng_query_video_task
根据 task_id 查询任务状态和结果。
3. jimeng_generate_video_and_wait ⭐ 推荐
一站式工具:提交任务并自动轮询等待结果(最多 5 分钟),直接返回视频 URL。
使用示例
在 Cursor 中直接对话:
"用这张图生成一段 5 秒的视频,镜头缓缓拉远" + 提供图片 URL
"Generate a 10s video from this image with camera slowly panning left"
"把这张风景照变成视频,加上飘落的树叶效果"
参数说明
参数 | 说明 |
| 视频运动/内容描述,中英文均可,建议 400 字以内 |
| 首帧图片 URL(JPEG/PNG,最大 4.7MB) |
| 首帧图片 base64(与 image_url 二选一) |
| 帧数:121 = 5秒,241 = 10秒(默认 121) |
| 随机种子,-1 为随机(默认 -1) |
图片要求
格式:JPEG 或 PNG
文件大小:最大 4.7MB
分辨率:最大 4096×4096,最短边不低于 320px
宽高比:长边与短边比例在 3 以内
注意事项
⏱️ 视频生成较慢,通常需要 1-3 分钟
🔗 视频 URL 有效期仅 1 小时,请及时下载
🎬 输出为 720P 分辨率视频
排查问题
与图片 MCP 相同,可运行诊断工具:
VOLC_ACCESS_KEY_ID=你的AK VOLC_SECRET_ACCESS_KEY=你的SK npm run test-connectionAvailable Tools
3 toolsjimeng_generate_videoGenerate Video (Jimeng Video 3.0)A
Submit a video generation task using Jimeng Video 3.0 (即梦视频3.0).
This is an image-to-video (first frame) model. You provide:
A first-frame image (URL or base64) as the starting visual
A text prompt describing the desired motion/action
Output: 720P video, either 5 seconds (121 frames) or 10 seconds (241 frames).
Args:
prompt (string, required): Text description of desired video motion/content. Chinese or English. Max ~800 chars.
image_url (string, optional): URL of the first-frame image. JPEG/PNG, max 4.7MB, max 4096x4096, min short side 320px, aspect ratio within 3:1.
image_base64 (string, optional): Base64-encoded first-frame image. Same constraints as image_url.
frames (number, optional): Total frames. 121 = 5 seconds, 241 = 10 seconds. Default: 121 (5s).
seed (number, optional): Random seed for reproducibility. Default: -1 (random).
Note: Either image_url or image_base64 must be provided (one of the two).
Returns: task_id for querying results with jimeng_query_video_task.
Examples:
prompt="镜头缓缓拉远,花瓣随风飘落" + image_url="https://..." -> 5s video
prompt="The camera slowly zooms out as petals fall" + image_url="https://..." + frames=241 -> 10s video
Inputs: prompt (required), seed, frames, image_url, +1 more.
jimeng_generate_video_and_waitGenerate Video and Wait (Jimeng Video 3.0)A
Generate a video using Jimeng Video 3.0 and automatically poll until complete.
Convenience tool that combines jimeng_generate_video + jimeng_query_video_task. Submits the task and polls for the result, returning the video URL when done.
All parameters are the same as jimeng_generate_video. Timeout: ~5 minutes (video generation is slower than image generation). Polling interval: 10 seconds.
Args:
prompt (string, required): Video motion/content description (Chinese or English, max 800 chars)
image_url (string, optional): First-frame image URL (JPEG/PNG)
image_base64 (string, optional): First-frame image as base64
frames (number, optional): 121 for 5s, 241 for 10s. Default: 121
seed (number, optional): Random seed. Default: -1
Note: Either image_url or image_base64 is required.
Returns: Video URL (valid 1 hour) or error message.
Inputs: prompt (required), seed, frames, image_url, +1 more.
jimeng_query_video_taskQuery Video Task (Jimeng Video 3.0)ARead-onlyIdempotent
Query the status and result of a Jimeng Video 3.0 generation task.
Use after calling jimeng_generate_video to get the generated video. Video generation typically takes 1-3 minutes. If status is "in_queue" or "generating", wait and query again.
Args:
task_id (string, required): The task ID returned by jimeng_generate_video.
Returns:
status: in_queue | generating | done | not_found | expired
video_url: Generated video URL (when done, valid for 1 hour only!)
Important: Video URLs expire after 1 hour. Download promptly.
Inputs: task_id (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clear boundaries: submit, query, and a combined submit-and-wait convenience tool. The only ambiguity is jimeng_generate_video_and_wait overlapping with the explicit two-step flow, but the description clearly frames it as a convenience wrapper.
All tools follow a consistent jimeng_<verb>_<noun> snake_case pattern (jimeng_generate_video, jimeng_query_video_task, jimeng_generate_video_and_wait), and the query verb matches its task_id return/argument naming.
Three tools is slightly thin but justified for an async generation service: submit, query, and a synchronous convenience variant. It covers the essential workflow without bloat.
The full generate→poll lifecycle is covered, including a blocking convenience variant. Minor gaps: no cancellation, task listing, or asset/upload handling, but the domain (image-to-video generation) is otherwise well-served.
Maintenance
Related MCP Connectors
Start a video generation job and poll it until the clip is ready; video price plus $0.01 a call.
Start a video generation job and poll it until the clip is ready; video price plus $0.01 a call.
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/…
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI image generation using Doubao Seedream models and video generation using Doubao Seedance models through Volcano Engine's API, supporting text-to-image, image-to-image, text-to-video, and task status queries.342 npm4MIT
- 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.337 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.47 npm30MIT
- AlicenseAqualityDmaintenanceEnables video generation from text prompts or images using Agnes AI's video models, with async task submission and status polling.219 npm1MIT