Jimeng Video MCP Server (即梦视频3.0 图生视频)

一个用于在 Cursor 中调用即梦视频 3.0 图生视频（首帧）API 的 MCP 服务器。

功能

• 图生视频（首帧模式）: 提供一张首帧图片 + 文字描述，生成 720P 视频
• 5s / 10s 时长: 支持 121 帧（5秒）或 241 帧（10秒）
• 中英文 Prompt: 支持中英文混合描述
• 可复现: 通过 seed 参数可复现相同视频

安装

常规安装（海外环境）

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