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

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

## 功能

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

## 安装

### 常规安装（海外环境）
```bash
cd jimeng-video-mcp-server
npm install
npm run build
```

### 国内环境安装（解决 SSL 证书/网络问题）
如果在国内使用时遇到 SSL 证书错误、安装缓慢或连接超时问题，请使用以下命令：
```bash
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）添加：

```json
{
  "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 相同，可运行诊断工具：

```bash
VOLC_ACCESS_KEY_ID=你的AK VOLC_SECRET_ACCESS_KEY=你的SK npm run test-connection
```
```