Flyworks MCP: бесплатный и быстрый инструмент Zeroshot Lipsync

Обзор

Flyworks MCP — это сервер Model Context Protocol (MCP), который предоставляет удобный интерфейс для взаимодействия с API Flyworks. Он обеспечивает быстрое и бесплатное создание видео с синхронизацией губ для широкого спектра цифровых аватаров, включая реалистичные и мультяшные стили.

Демо

Входное видео аватара (кадры):

Аудиоклип с TTS saying我是一个飞影数字人。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. :

Сгенерированное видео с синхронизацией губ:

Функции

• Создавайте синхронизированные видеоролики, используя в качестве входных данных видео и аудио цифрового аватара

• Создавайте синхронизированные с текстом видеоролики (с преобразованием текста в речь)

• Создавайте цифровые человеческие аватары из изображений и видео

• Поддержка как асинхронного, так и синхронного режимов работы

• Скоро появятся новые функции...

Требования

• Питон 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 -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server , чтобы добавить указанную выше конфигурацию.

Обязательно замените your_api_token_here на ваш фактический токен API и обновите FLYWORKS_MCP_BASE_PATH , указав допустимый каталог в вашей системе, в котором будут сохраняться выходные файлы.

Примечание: Мы предлагаем бесплатный пробный доступ к нашему инструменту с токеном 2aeda3bcefac46a3 . Однако имейте в виду, что ежедневная квота для этого бесплатного доступа ограничена. Кроме того, сгенерированные видео будут помечены водяными знаками и ограничены продолжительностью 45 секунд. Для получения полного доступа свяжитесь с нами по адресу bd@flyworks.ai , чтобы получить свой токен.

Установка через Smithery

Чтобы автоматически установить flyworks-mcp для Claude Desktop через Smithery :

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. Конфигурация

Установите свой токен API Flyworks как переменную среды:

# 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 : Цифровой идентификатор человеческого аватара. Необходимо указать либо это, либо параметры создания аватара.

• 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.

• Если идентификатор аватара указан напрямую, эти параметры будут проигнорированы.

Возврат :

• Если async_mode имеет значение true: task_id для проверки статуса позже и created_avatar (если был создан новый аватар)

• Если async_mode имеет значение false: путь к загруженному видео, результат задачи и created_avatar (если применимо)

2. Создать видео с синхронизацией губ по тексту ( create_lipsync_video_by_text )

Создать видео с синхронизацией губ с текстовым вводом. Генерирует аудио из текста и анимирует цифровой человеческий аватар, чтобы он его озвучил.

Параметры :

• avatar : Цифровой идентификатор человеческого аватара. Необходимо указать либо это, либо параметры создания аватара.

• avatar_video_url : URL-адрес видео, из которого будет создан аватар.

• avatar_image_url : URL-адрес изображения, из которого будет создан аватар.

• avatar_video_file : Локальный путь к видеофайлу, из которого будет создан аватар.

• avatar_image_file : Локальный путь к файлу изображения, из которого будет создан аватар.

• text : Текстовое содержимое, которое будет озвучено аватаром. Обязательно.

• voice : идентификатор голоса для использования при преобразовании текста в речь. Если не указано, автоматически будет выбран случайный голос.

• 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.

• Если идентификатор аватара указан напрямую, эти параметры будут проигнорированы.

Возврат :

• Если async_mode имеет значение true: task_id для проверки статуса позже, выбранный голосовой идентификатор и created_avatar (если применимо)

• Если async_mode имеет значение false: загруженный путь к видео, результат задачи, выбранный идентификатор голоса и created_avatar (если применимо)

Проверка статуса задачи

Для задач, запущенных в асинхронном режиме, вы можете проверить их статус с помощью конечной точки API Flyworks /creation/task с помощью task_id, возвращаемого инструментом.

Примечания

• Обработка задания может занять некоторое время, пожалуйста, проявите терпение.

• URL-адреса видеофайлов являются временными, пожалуйста, скачайте и сохраните их как можно скорее.

• При использовании локальных файлов сервер автоматически загрузит их на серверы Flyworks.

• В режиме синхронизации инструмент будет ждать завершения задачи и автоматически загрузит видео.

• Максимально допустимое время ожидания для режима синхронизации составляет 10 минут (600 секунд).

• Создание аватара с помощью видео обычно обеспечивает лучшее качество, но занимает больше времени.

• Для быстрого тестирования создание аватара с помощью изображений выполняется быстрее, но может иметь более низкое качество.

Ссылки по теме

• Документация по открытой платформе Flyworks AI

• Документация по протоколу контекста модели (MCP)

• Python MCP SDK