Flyworks MCP: Free & Fast Zeroshot Lipsync Tool

Flyworks MCP：免费且快速的 Zeroshot 唇形同步工具

概述

Flyworks MCP 是一个模型上下文协议（MCP）服务，为使用 Flyworks API 提供便捷的接口。它能够快速、免费地创建唇形同步视频，支持多种数字化身，包括写实风格和卡通风格。

演示

输入数字化身视频（素材）：

朗读 我是一个飞影数字人。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. 的 TTS 音频片段：

生成的唇形同步视频：

功能

• 使用数字化身视频和音频作为输入，创建唇形同步视频
• 通过文本创建唇形同步视频（支持文本转语音）
• 根据图像或视频创建数字人化身
• 支持异步和同步两种运行模式
• 更多功能即将推出……

要求

• 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。但请注意，免费访问的每日配额有限。此外，生成的视频会带有水印，时长限制为 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 之一。
• 若直接提供头像 ID，则会忽略这些参数。

返回值：

• 若 async_mode 为 true：用于稍后检查状态的 task_id，以及 created_avatar（若创建了新头像）
• 若 async_mode 为 false：下载的视频路径、任务结果，以及 created_avatar（如适用）

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 之一。
• 若直接提供头像 ID，则会忽略这些参数。

返回值：

• 若 async_mode 为 true：用于稍后检查状态的 task_id、所选声音 ID，以及 created_avatar（如适用）
• 若 async_mode 为 false：下载的视频路径、任务结果、所选声音 ID，以及 created_avatar（如适用）

检查任务状态

对于以异步模式运行的任务，可使用 Flyworks API 的 /creation/task 端点和工具返回的 task_id 检查状态。

注意事项

• 任务处理可能需要一些时间，请耐心等待
• 视频文件 URL 是临时的，请尽快下载并保存
• 使用本地文件时，服务器会自动将其上传到 Flyworks 服务器
• 在同步模式下，工具会等待任务完成并自动下载视频
• 同步模式下允许的最长等待时间为 10 分钟（600 秒）
• 通过视频创建头像通常质量更好，但耗时更长
• 快速测试时，通过图片创建头像会更快，但质量可能较低

相关链接

• Flyworks AI 开放平台文档
• Model Context Protocol（MCP）文档
• Python MCP SDK