Skip to main content
Glama
jimeng-video-mcp-server

jimeng-video-mcp-server

by SA-GIMA

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"

  • "把这张风景照变成视频,加上飘落的树叶效果"

参数说明

参数

说明

prompt

视频运动/内容描述,中英文均可,建议 400 字以内

image_url

首帧图片 URL(JPEG/PNG,最大 4.7MB)

image_base64

首帧图片 base64(与 image_url 二选一)

frames

帧数:121 = 5秒,241 = 10秒(默认 121)

seed

随机种子,-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-connection

Available Tools

3 tools
jimeng_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)A
Read-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

    A4.5/5.0

    Scored across 3 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers