PixVerse MCP

PixVerse MCP

这是一款功能全面的工具，可让你通过支持 Model Context Protocol（MCP）的应用（例如 Claude 或 Cursor）访问 PixVerse 最新的视频生成模型。可根据文本生成视频、制作图像动画、创建转场、添加唇形同步和音效等！

中文文档

https://github.com/user-attachments/assets/08ce90b7-2591-4256-aff2-9cc51e156d00

概述

PixVerse MCP 是一款强大的工具，可让你通过支持 Model Context Protocol（MCP）的应用访问 PixVerse 最新的视频生成模型。借助此集成，你可以生成高质量视频，并使用文本生成视频、图像生成视频、视频扩展、转场、唇形同步、音效等高级功能。

主要功能

• 文本生成视频：使用文本提示词生成创意视频
• 图像生成视频动画：将静态图像制作成动态视频
• 灵活的参数控制：调整视频质量、时长、宽高比等
• 视频扩展：无缝延长现有视频，生成更长的序列
• 场景转场：在不同图像之间创建平滑变形效果
• 唇形同步：使用 TTS 或自定义音频，为人物讲话视频添加逼真的唇形同步
• 音效：根据视频内容生成契合情境的音效
• 融合视频：将多个主体合成到同一场景中（仅限 v4.5）
• 资源管理：从本地文件或 URL 上传图像和视频
• 与 AI 助手共同创作：与 Claude 等 AI 模型协作，优化创作工作流

系统组件

系统由两个主要组件组成：

1. UVX MCP 服务
   • 基于 Python 的云端服务
   • 直接与 PixVerse API 通信
   • 提供完整的视频生成功能

安装与配置

前提条件

1. Python 3.10 或更高版本
2. UV/UVX
3. PixVerse API 密钥：从 PixVerse 平台获取（此功能需要 API Credits，必须在 PixVerse Platform 单独购买）

获取依赖项

1. Python：

   • 从 Python 官方网站下载并安装
   • 确保 Python 已添加到系统路径

2. UV/UVX：

   • 安装 uv，并设置 Python 项目和环境：

Mac/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

如何使用 MCP 服务

1. 获取 PixVerse API 密钥

• 访问 PixVerse Platform
• 注册或登录账户
• 在账户设置中创建并复制 API 密钥
• API 密钥生成指南

2. 下载所需依赖项

• Python：安装 Python 3.10 或更高版本
• UV/UVX：安装最新的稳定版 UV 和 UVX

3. 配置 MCP 客户端

• 打开 MCP 客户端（例如 Claude 桌面版或 Cursor）
• 找到客户端设置
• 打开 mcp_config.json（或相关配置文件）
• 根据使用的方法添加配置：

{
  "mcpServers": {
    "PixVerse": {
      "command": "uvx",
      "args": [
        "pixverse-mcp"
      ],
      "env": {
        "PIXVERSE_API_KEY": "your-api-key-here"
      }
    }
  }
}

• 在 "PIXVERSE_API_KEY": "xxxx" 中添加从 platform.pixverse.ai 获取的 API 密钥
• 保存配置文件

5. 重启 MCP 客户端或刷新 MCP 服务

• 完全关闭并重新打开 MCP 客户端
• 或使用“刷新 MCP 服务”选项（如果支持）

客户端专属配置

Claude 桌面版

1. 打开 Claude 应用
2. 前往 Claude > Settings > Developer > Edit Config
3. 打开 claude_desktop_config.json 文件
   • Windows
   • Mac：~/Library/Application\ Support/Claude/claude_desktop_config.json
4. 添加上述配置并保存
5. 重启 Claude
   • 如果连接成功：主页不会显示任何错误，MCP 状态将显示为绿色
   • 如果连接失败：主页将显示错误消息

Cursor

1. 打开 Cursor 应用
2. 前往 Settings > Model Context Protocol
3. 添加新服务
4. 按照上述 JSON 配置填写服务详情
5. 保存并重启或刷新 MCP 服务

高级用法示例

文本转视频

通过 Claude 或 Cursor 使用自然语言提示词生成视频。

基础示例：

Generate a video of a sunset over the ocean. Golden sunlight reflects on the water as waves gently hit the shore.

带参数的高级示例：

Generate a night cityscape video with the following parameters:
Content: Skyscraper lights twinkling under the night sky, with car lights forming streaks on the road
Aspect Ratio: 16:9
Quality: 540p
Duration: 5 seconds
Motion Mode: normal
Negative Prompts: blur, shaking, text

支持的参数：

• 宽高比：16:9、4:3、1:1、3:4、9:16
• 时长：5s 或 8s
• 画质：360p、540p、720p、1080p
• 动态模式：normal 或 fast

脚本 + 视频

使用详细的场景描述或镜头列表，创建结构更完整的视频。

场景描述示例：

Scene: A beach in the early morning.
The sun is rising, casting golden reflections on the sea.
Footprints stretch across the sand.
Gentle waves leave white foam as they retreat.
A small boat slowly sails across the calm sea in the distance.
Aspect Ratio: 16:9, Quality: 540p, Duration: 5 seconds.

逐镜头示例：

Generate a video based on this storyboard:
- Start: Top-down shot of a coffee cup with steam rising
- Close-up: Ripples and texture on the coffee surface
- Transition: Stirring creates a vortex
- End: An open book and glasses next to the cup
Format: 1:1 square, Quality: 540p, Motion: fast

• Claude Desktop 还支持输入故事板图像。

一键生成视频

无需详细描述，即可快速生成特定主题或风格的视频。

主题示例：

Generate a video with a futuristic technology theme, including neon lights and holographic projections.

风格示例：

Generate a watercolor-style video of blooming flowers with bright, dreamy colors.

创意 + 视频

将 AI 的创造力与视频生成相结合。

风格迁移示例：

This is a photo of a cityscape. Reinterpret it with a retro style and provide a video prompt.

故事提示词示例：

If this street photo is the opening scene of a movie, what happens next? Provide a short video concept.

情感场景示例：

Look at this forest path photo and design a short video concept, either a micro-story or a scene with emotional progression.

功能使用指南

文本转视频

Generate a sunset ocean video with golden sunlight reflecting on the water

带参数的示例：

Prompt: "A majestic eagle soaring over mountain peaks at sunrise"
Quality: 720p
Duration: 5
Model: v5
Aspect Ratio: 16:9

参数：画质（360p-1080p）、时长（5s/8s）、宽高比（16:9/1:1/9:16）、模型（v4.5/v5）

图像转视频

1. Upload image → Get img_id
2. Use img_id to generate animated video

带参数的示例：

Prompt: "The character walks through a magical forest with glowing trees"
img_id: 12345
Quality: 720p
Duration: 5s
Model: v5

视频延长

Use source_video_id to extend existing video

带参数的示例：

Prompt: "The scene continues with the character discovering a hidden cave"
source_video_id: 67890
Duration: 5s
Quality: 720p
Model: v5

场景转场

Upload two images to create smooth morphing animation

带参数的示例：

Prompt: "Transform from sunny beach to stormy night sky"
first_frame_img: 11111
last_frame_img: 22222
Duration: 5s
Quality: 720p
Model: v5

口型同步

Video: 
TTS: Choose speaker + input text
Audio: Upload audio file + video

带参数的示例：

# Method 1: Generated Video + TTS
source_video_id: 33333
lip_sync_tts_speaker_id: "speaker_001"
lip_sync_tts_content: "Welcome to our amazing video tutorial"

# Method 2: Generated Video + Custom Audio
source_video_id: 33333
audio_media_id: 44444

# Method 3: Uploaded Video + TTS
video_media_id: 55555  # Upload your video first
lip_sync_tts_speaker_id: "speaker_002"
lip_sync_tts_content: "This is a custom narration"

# Method 4: Uploaded Video + Custom Audio
video_media_id: 55555  # Upload your video first
audio_media_id: 44444  # Upload your audio first

音效

Describe effects: "Ocean waves, seagull calls, gentle wind"

带参数的示例：

# Method 1: Generated Video + Sound Effects
sound_effect_content: "Gentle ocean waves, seagull calls, soft wind"
source_video_id: 55555
original_sound_switch: true  # Keep original audio

# Method 2: Uploaded Video + Sound Effects
sound_effect_content: "Urban traffic, footsteps, city ambiance"
video_media_id: 66666  # Upload your video first
original_sound_switch: false  # Replace original audio

# Method 3: Replace Audio Completely
sound_effect_content: "Epic orchestral music, thunder, dramatic tension"
video_media_id: 77777  # Upload your video first
original_sound_switch: false  # Replace with new audio

融合视频

Upload multiple images, use @ref_name references
Example: @person standing in front of @city with @drone flying overhead

带参数的示例：

Prompt: "@hero standing in front of @city with @drone flying overhead"
image_references: [
  {type: "subject", img_id: 66666, ref_name: "hero"},
  {type: "background", img_id: 77777, ref_name: "city"},
  {type: "subject", img_id: 88888, ref_name: "drone"}
]
Duration: 5s
Model:v4.5
Quality: 720p
Aspect Ratio: 16:9

📊 状态监控

Check video_id status every 6 seconds until completion

带参数的示例：

video_id: 99999
# Check every 6 seconds until status becomes "completed" or "failed"
# Typical generation time: 60-120 seconds

状态：pending → in_progress → completed/failed

常见问题

如何获取 PixVerse API 密钥？

• 在 PixVerse Platform 注册，然后在账户的“API-KEY”下生成密钥。

如果服务没有响应，该怎么办？

1. 检查 API 密钥是否有效
2. 确保配置文件路径正确
3. 查看错误日志（通常位于 Claude 或 Cursor 的日志文件夹中）

MCP 是否支持图生视频或关键帧功能？

• 暂不支持。这些功能仅可通过 PixVerse API 使用。API 文档

如何获取额度？

• 如果你还没有在 API 平台充值，请先充值。PixVerse Platform

支持哪些视频格式和尺寸？

• PixVerse 支持 360p 到 1080p 的分辨率，以及 9:16（竖屏）到 16:9（横屏）的宽高比。
• 建议先使用 540p 和 5 秒视频测试输出质量。

在哪里可以找到生成的视频？

• 你会收到一个 URL 链接，可用于查看、下载或分享视频。

视频生成需要多长时间？

• 通常需要 30 秒到 2 分钟，具体取决于视频复杂度、服务端负载和网络状况。

遇到 spawn uvx ENOENT 错误该怎么办？

• 此错误通常由 UV/UVX 安装路径不正确导致。可按以下步骤解决：

对于 Mac/Linux：

sudo cp ./uvx /usr/local/bin

对于 Windows：

1. 在终端运行以下命令，确定 UV/UVX 的安装路径：

where uvx

2. 打开文件资源管理器并找到 uvx/uv 文件。
3. 将文件移至以下目录之一：
   • C:\Program Files (x86) 或 C:\Program Files

社区与支持

社区

• 加入我们的 Discord 服务器，获取最新动态、分享创作、寻求帮助或提供反馈。

技术支持

• 电子邮件：[email protected]
• 网站：https://platform.pixverse.ai

发布说明

v2.0.0（最新）

• 新增：图生视频动画
• 新增：延长视频以生成更长的片段
• 新增：图像之间的场景转场
• 新增：支持 TTS 和自定义音频的唇形同步
• 新增：AI 生成的音效
• 新增：用于合成场景的 Fusion 视频
• 新增：TTS 说话人选择
• 新增：通过文件或 URL 上传资源（图像/视频）
• 新增：实时状态监控
• 改进：增强错误处理和用户反馈
• 改进：支持并行生成视频

v1.0.0

• 支持通过 MCP 生成文生视频
• 支持获取视频链接
• 与 Claude 和 Cursor 集成，提升工作流体验
• 支持基于云的 Python MCP 服务