Flyworks MCP: Free & Fast Zeroshot Lipsync Tool

Flyworks MCP：無料かつ高速なゼロショットリップシンクツール

概要

Flyworks MCP は、Flyworks API を操作するための便利なインターフェースを提供する Model Context Protocol（MCP）サーバーです。リアルなスタイルやアニメ風のスタイルなど、幅広いデジタルアバターのリップシンク動画を、無料かつ高速で作成できます。

デモ

入力アバター動画（映像）：

TTS で「我是一个飞影数字人。Welcome to Flyworks MCP server demo. This tool enables fast and free lipsync video creation for a wide range of digital avatars, including realistic and cartoon styles.」と読み上げる音声クリップ：

生成されたリップシンク動画：

特長

• デジタルアバターの動画と音声を入力として、リップシンク動画を作成
• テキストからリップシンク動画を作成（テキスト読み上げ機能付き）
• 画像または動画からデジタルヒューマンアバターを作成
• 非同期モードと同期モードの両方に対応
• 今後、さらに機能を追加予定です……

要件

• Python 3.8+
• 依存関係：httpx、mcp[cli]

使用方法

Claude またはその他の MCP クライアントとの連携

Claude Desktop での使用

Claude > Settings > Developer > Edit Config > claude_desktop_config.json に移動し、以下を追加します。

{
  "mcpServers": {
    "flyworks": {
      "command": "uvx",
      "args": [
        "flyworks-mcp",
        "-y"
      ],
      "env": {
        "FLYWORKS_API_TOKEN": "your_api_token_here",
        "FLYWORKS_API_BASE_URL": "https://hfw-api.hifly.cc/api/v2/hifly",
        "FLYWORKS_MCP_BASE_PATH": "/path/to/your/output/directory"
      }
    }
  }
}

Cursor での使用

Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server に移動し、上記の設定を追加します。

your_api_token_here を実際の API トークンに置き換え、FLYWORKS_MCP_BASE_PATH を、出力ファイルの保存先としてシステム上の有効なディレクトリに変更してください。

注： トークン 2aeda3bcefac46a3 を使って、ツールを無料でお試しいただけます。ただし、この無料アクセスには1日あたりの利用上限があります。また、生成される動画には透かしが入り、長さは45秒までに制限されます。すべての機能をご利用になるには、[email protected] までお問い合わせのうえ、トークンを取得してください。

Smithery 経由でインストール

Smithery 経由で Claude Desktop に flyworks-mcp を自動インストールするには：

npx -y @smithery/cli install @Flyworks-AI/flyworks-mcp --client claude

ローカルにインストール

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/flyworks-mcp.git
   cd flyworks-mcp
   

2. 依存関係をインストールします：

   pip install httpx "mcp[cli]>=1.6.0"
   

   または、uv を使う場合：

   uv pip install httpx "mcp[cli]>=1.6.0"
   

   サーバー起動時のタイムアウトを防ぐため、すべての依存関係を事前にインストールすることをおすすめします：

   pip install pygments pydantic-core httpx "mcp[cli]>=1.6.0"
   

3. 設定

Flyworks API トークンを環境変数として設定します：

# Linux/macOS
export FLYWORKS_API_TOKEN="your_token_here"

# Windows (Command Prompt)
set FLYWORKS_API_TOKEN=your_token_here

# Windows (PowerShell)
$env:FLYWORKS_API_TOKEN="your_token_here"

または、.env ファイルを作成できます。

4. サーバーの実行

server.py ファイルを直接実行します：

python server.py

spawn uvx ENOENT の問題：

ターミナルで次のコマンドを実行し、絶対パスを確認してください：

which uvx

絶対パス（例：/usr/local/bin/uvx）がわかったら、そのパスを使うように設定を更新してください（例："command": "/usr/local/bin/uvx"）。

ツールの説明

1. 音声からリップシンク動画を作成する（create_lipsync_video_by_audio）

音声を入力してリップシンク動画を作成します。デジタルヒューマンアバターを、入力された音声に合わせて話すようにアニメーション化します。

パラメーター：

• avatar：デジタルヒューマンアバターの ID です。これか、アバター作成用パラメーターのいずれかを指定する必要があります。
• avatar_video_url：アバターの作成元となる動画の URL です。
• avatar_image_url：アバターの作成元となる画像の URL です。
• avatar_video_file：アバターの作成元となる動画ファイルのローカルパスです。
• avatar_image_file：アバターの作成元となる画像ファイルのローカルパスです。
• audio_url：音声ファイルのリモート URL です。audio_url または audio_file のいずれかを指定する必要があります。
• audio_file：音声ファイルのローカルパスです。audio_url または audio_file のいずれかを指定する必要があります。
• title：作成する動画の任意のタイトルです。
• async_mode：true の場合、すぐに task_id を返します。false の場合、処理の完了を待って動画をダウンロードします。デフォルトは true です。
• output_path：async_mode が false の場合に、ダウンロードした動画を保存する場所です。デフォルトは "output.mp4" です。

注意事項：

• アバターを作成するには、avatar_video_url、avatar_image_url、avatar_video_file、avatar_image_file のうち、いずれか 1 つだけを指定してください。
• アバター ID を直接指定した場合、これらのパラメーターは無視されます。

戻り値：

• async_mode が true の場合：後でステータスを確認するための task_id と、作成したアバター（新しいアバターを作成した場合）
• async_mode が false の場合：ダウンロードした動画のパス、タスクの結果、作成したアバター（該当する場合）

2. テキストからリップシンク動画を作成する（create_lipsync_video_by_text）

テキストを入力してリップシンク動画を作成します。テキストから音声を生成し、デジタルヒューマンアバターがその内容を話すようにアニメーション化します。

パラメーター：

• avatar：デジタルヒューマンアバターの ID です。これか、アバター作成用パラメーターのいずれかを指定する必要があります。
• avatar_video_url：アバターの作成元となる動画の URL です。
• avatar_image_url：アバターの作成元となる画像の URL です。
• avatar_video_file：アバターの作成元となる動画ファイルのローカルパスです。
• avatar_image_file：アバターの作成元となる画像ファイルのローカルパスです。
• text：アバターに話させるテキストです。必須です。
• voice：テキスト読み上げに使用する音声 ID です。指定しない場合は、音声が自動的にランダムで選択されます。
• title：作成する動画の任意のタイトルです。
• async_mode：true の場合、すぐに task_id を返します。false の場合、処理の完了を待って動画をダウンロードします。デフォルトは true です。
• output_path：async_mode が false の場合に、ダウンロードした動画を保存する場所です。デフォルトは "output.mp4" です。

注意事項：

• アバターを作成するには、avatar_video_url、avatar_image_url、avatar_video_file、avatar_image_file のうち、いずれか 1 つだけを指定してください。
• アバター ID を直接指定した場合、これらのパラメーターは無視されます。

戻り値：

• async_mode が true の場合：後でステータスを確認するための task_id、選択された音声 ID、作成したアバター（該当する場合）
• async_mode が false の場合：ダウンロードした動画のパス、タスクの結果、選択された音声 ID、作成したアバター（該当する場合）

タスクのステータスを確認する

非同期モードで実行したタスクのステータスは、ツールが返した task_id を使って、Flyworks API の /creation/task エンドポイントから確認できます。

注意事項

• ジョブの処理には時間がかかる場合があります。しばらくお待ちください。
• 動画ファイルの URL は一時的なものです。速やかにダウンロードして保存してください。
• ローカルファイルを使用すると、サーバーが自動的に Flyworks サーバーへアップロードします。
• 同期モードでは、ツールがタスクの完了を待ち、動画を自動的にダウンロードします。
• 同期モードで許可される最大待機時間は 10 分（600 秒）です。
• 動画を使ったアバターの作成は、通常、より高品質になりますが、時間がかかります。
• 手早くテストする場合は、画像を使ったアバターの作成のほうが速い一方、品質が低くなることがあります。

関連リンク

• Flyworks AI オープンプラットフォームのドキュメント
• Model Context Protocol（MCP）のドキュメント
• Python MCP SDK