飞工作-mcp

Name: 飞工作-mcp
Author: Flyworks-AI

作者：Flyworks-AI90 星标更新：2025-05-20

安装使用来源：spider==github.com

项目介绍

Flyworks MCP：免费且快速的零样本口型同步工具

概述

Flyworks MCP 是一个模型上下文协议（MCP）服务器，提供了与 Flyworks API 交互的便捷接口。它支持快速且免费地创建各种数字角色的口型同步视频，包括写实风格和卡通风格的角色。

示例

输入角色视频片段：

带有 TTS 的音频剪辑，内容为 我是一个飞影数字人。欢迎来到 Flyworks MCP 服务器演示。此工具支持快速且免费地创建各种数字角色的口型同步视频，包括写实风格和卡通风格的角色。：

生成的口型同步视频：

特性

使用数字角色视频和音频作为输入来创建口型同步视频
使用文本（通过文本转语音）来创建口型同步视频
从图像或视频中创建数字人类角色
支持异步和同步操作模式
更多特性即将推出...

要求

Python 3.8+
依赖项：httpx, mcp[cli]

使用方法

与 Claude 或其他 MCP 客户端集成

在 Claude Desktop 中使用

前往 Claude > 设置 > 开发者 > 编辑配置 > 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 -> 首选项 -> Cursor 设置 -> MCP -> 添加新的全局 MCP 服务器 来添加上述配置。

确保将 your_api_token_here 替换为您的实际 API 密钥，并更新 FLYWORKS_MCP_BASE_PATH 到系统上有效的目录，输出文件将保存在此目录中。

注意： 我们提供免费试用访问，密钥为 2aeda3bcefac46a3。然而，请注意，此免费访问的每日配额有限。此外，生成的视频将带有水印并限制在 45 秒内。如需完全访问，请联系 bd@flyworks.ai 获取您的密钥。

通过 Smithery 安装

要通过 Smithery 自动安装 flyworks-mcp 到 Claude Desktop：

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

本地安装

克隆此仓库：

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

安装依赖项：

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"

配置

设置您的 Flyworks API 密钥为环境变量：

# Linux/macOS
export FLYWORKS_API_TOKEN="your_token_here"

# Windows (命令提示符)
set FLYWORKS_API_TOKEN=your_token_here

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

或者，您可以创建一个 .env 文件。

运行服务器

直接运行 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: 如果为真，则立即返回任务ID。如果为假，则等待完成并下载视频。默认为真。
output_path: 如果 async_mode 为假，则保存下载视频的位置。默认为 "output.mp4"。

注意事项：

对于角色创建，必须提供 avatar_video_url、avatar_image_url、avatar_video_file 或 avatar_image_file 中的一个。
如果直接提供角色ID，则忽略这些参数。

返回值：

如果 async_mode 为真：用于稍后检查状态的任务ID以及创建的角色（如果创建了新角色）
如果 async_mode 为假：下载的视频路径、任务结果以及创建的角色（如果适用）

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: 如果为真，则立即返回任务ID。如果为假，则等待完成并下载视频。默认为真。
output_path: 如果 async_mode 为假，则保存下载视频的位置。默认为 "output.mp4"。