PixVerse MCP

PixVerse MCP

Claude や Cursor など、Model Context Protocol（MCP）をサポートするアプリケーションを通じて、PixVerse の最新の動画生成モデルを利用できる包括的なツールです。テキストからの動画生成、画像のアニメーション化、トランジションの作成、リップシンクや効果音の追加など、さまざまな機能を利用できます！

中文文档

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

概要

PixVerse MCP は、Model Context Protocol（MCP）をサポートするアプリケーションを通じて、PixVerse の最新の動画生成モデルを利用できる強力なツールです。この連携により、テキストから動画、画像から動画、動画の延長、トランジション、リップシンク、効果音などの高度な機能を使って、高品質な動画を生成できます。

主な機能

• テキストから動画を生成：テキストプロンプトを使ってクリエイティブな動画を生成します
• 画像から動画へのアニメーション化：静止画像を動きのある動画にアニメーション化します
• 柔軟なパラメーター制御：動画の品質、長さ、アスペクト比などを調整します
• 動画の延長：既存の動画をシームレスに延長し、より長いシーケンスを作成します
• シーントランジション：異なる画像間の滑らかな変形を作成します
• リップシンク：TTS またはカスタムオーディオを使って、トーキングヘッド動画に自然なリップシンクを追加します
• 効果音：動画の内容に基づいて、文脈に合った効果音を生成します
• Fusion Video：複数の被写体を 1 つのシーンに合成します（v4.5 のみ）
• リソース管理：ローカルファイルまたは URL から画像や動画をアップロードします
• AI アシスタントとの共同制作：Claude などの AI モデルと協力し、クリエイティブなワークフローを強化します

システムコンポーネント

システムは、次の 2 つの主要コンポーネントで構成されています。

1. UVX MCP サーバー
   • Python ベースのクラウドサーバー
   • PixVerse API と直接通信します
   • 動画生成機能をすべて提供します

インストールと設定

前提条件

1. Python 3.10 以降
2. UV/UVX
3. PixVerse API キー：PixVerse Platform から取得します（この機能には API クレジットが必要です。クレジットは 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 for Desktop または Cursor）を開きます
• クライアントの設定を探します
• mcp_config.json（または該当する設定ファイル）を開きます
• 使用する方法に応じて設定を追加します。

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

• platform.pixverse.ai から取得した API キーを "PIXVERSE_API_KEY": "xxxx" に追加します
• 設定ファイルを保存します

5. MCP クライアントを再起動するか、MCP サーバーを更新する

• MCP クライアントを完全に終了してから、再度開きます
• または、対応している場合は「MCP サーバーを更新」オプションを使用します

クライアント固有の設定

Claude for Desktop

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 Docs

クレジットを取得するにはどうすればよいですか？

• 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 server に参加して、最新情報を受け取ったり、作品を共有したり、サポートを受けたり、フィードバックを送ったりできます。

テクニカルサポート

• メール：[email protected]
• ウェブサイト：https://platform.pixverse.ai

リリースノート

v2.0.0（最新）

• 新機能：画像から動画へのアニメーション生成
• 新機能：長いシーケンス向けの動画延長
• 新機能：画像間のシーン切り替え
• 新機能：TTS とカスタム音声によるリップシンク
• 新機能：AI 生成の効果音
• 新機能：合成シーン向けの Fusion video
• 新機能：TTS の話者選択
• 新機能：ファイルまたは URL によるリソース（画像／動画）のアップロード
• 新機能：リアルタイムのステータス監視
• 改善：エラー処理とユーザーフィードバックの強化
• 改善：動画の並列生成に対応

v1.0.0

• MCP 経由のテキストから動画への生成に対応
• 動画リンクの取得に対応
• Claude および Cursor と連携し、ワークフローを強化
• クラウドベースの Python MCP サーバーに対応