Flyworks MCP: Free & Fast Zeroshot Lipsync Tool

基本能力

产品定位

Flyworks MCP 是一个专注于数字人口型同步视频生成的服务，通过 API 接口提供快速、免费的口型同步功能。

核心功能

• 使用数字头像视频和音频输入创建口型同步视频
• 通过文本（结合文本转语音）创建口型同步视频
• 从图像或视频创建数字人头像
• 支持异步和同步操作模式

适用场景

• 数字人视频内容创作
• 教育视频制作
• 娱乐内容生成
• 虚拟主播开发

工具列表

1. create_lipsync_video_by_audio: 通过音频输入创建口型同步视频
2. 参数包括数字人头像ID、音频URL/文件等

3. 支持异步和同步模式

4. create_lipsync_video_by_text: 通过文本输入创建口型同步视频

5. 参数包括数字人头像ID、文本内容、语音ID等
6. 自动生成音频并创建口型同步视频

常见问题解答

• 异步模式下如何检查任务状态：通过Flyworks API的/creation/task端点
• 视频文件URL是临时的，请及时下载
• 同步模式最大等待时间为10分钟
• 通过视频创建头像质量更好但耗时更长

使用教程

使用依赖

• Python 3.8+
• 依赖包: httpx, mcp[cli]

安装教程

1. 克隆仓库: bash git clone https://github.com/yourusername/flyworks-mcp.git cd flyworks-mcp

2. 安装依赖: bash pip install httpx "mcp[cli]>=1.6.0" 或使用uv: bash uv pip install httpx "mcp[cli]>=1.6.0"

3. 推荐预安装所有依赖以避免超时: bash pip install pygments pydantic-core httpx "mcp[cli]>=1.6.0"

配置

设置Flyworks API token环境变量:

# 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"

调试方式

1. 运行服务器: bash python server.py

2. 与Claude或其他MCP客户端集成:

3. 在Claude Desktop设置中添加MCP服务器配置

4. 在Cursor设置中添加全局MCP服务器

5. 解决spawn uvx ENOENT问题: sh which uvx 然后使用绝对路径更新配置

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。