Flyworks MCP

Un servidor para crear videos de lipsync rápidos y gratuitos para avatares digitales, compatible con estilos realistas y de dibujos animados.

GitHub

Prueba este MCPPatrocinado

Documentación

Flyworks MCP: Herramienta de Lipsync Zeroshot Gratuita y Rápida

Resumen

El Flyworks MCP es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona una interfaz conveniente para interactuar con la API de Flyworks. Facilita la creación rápida y gratuita de videos de lipsync para una amplia gama de avatares digitales, incluidos estilos realistas y de dibujos animados.

Demostración

Video de avatar de entrada (metraje):

Clip de audio con TTS diciendo 我是一个飞影数字人。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.:

Video de lipsync generado:

Características

Crear videos con lipsync usando video de avatar digital y audio como entradas
Crear videos con lipsync mediante texto (con texto a voz)
Crear avatares humanos digitales a partir de imágenes o videos
Soporte para modos de operación asíncronos y síncronos
Más características próximamente...

Requisitos

Python 3.8+
Dependencias: httpx, mcp[cli]

Uso

Integración con Claude u Otros Clientes MCP

Uso en Claude Desktop

Vaya a Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir lo siguiente:

{
  "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"
      }
    }
  }
}

Uso en Cursor

Vaya a Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server para agregar la configuración anterior.

Asegúrese de reemplazar your_api_token_here con su token de API real, y actualice el FLYWORKS_MCP_BASE_PATH a un directorio válido en su sistema donde se guardarán los archivos de salida.

Nota: Ofrecemos acceso de prueba gratuito a nuestra herramienta con el token 2aeda3bcefac46a3. Sin embargo, tenga en cuenta que la cuota diaria para este acceso gratuito es limitada. Además, los videos generados tendrán marca de agua y estarán restringidos a una duración de 45 segundos. Para acceso completo, contáctenos en bd@flyworks.ai para adquirir su token.

Instalación mediante Smithery

Para instalar flyworks-mcp para Claude Desktop automáticamente mediante Smithery:

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

Instalación local

Clone este repositorio:

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

Instale las dependencias:
```
pip install httpx "mcp[cli]>=1.6.0"
```
O usando uv:
```
uv pip install httpx "mcp[cli]>=1.6.0"
```
Para evitar problemas de tiempo de espera durante el inicio del servidor, recomendamos preinstalar todas las dependencias:
```
pip install pygments pydantic-core httpx "mcp[cli]>=1.6.0"
```
Configuración

Establezca su token de API de Flyworks como variable de entorno:

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

Alternativamente, puede crear un archivo .env.

Ejecución del Servidor

Ejecute el archivo server.py directamente:

python server.py

Problema de spawn uvx ENOENT:

Confirme su ruta absoluta ejecutando este comando en su terminal:

which uvx

Una vez que obtenga la ruta absoluta (por ejemplo, /usr/local/bin/uvx), actualice su configuración para usar esa ruta (por ejemplo, "command": "/usr/local/bin/uvx").

Descripción de Herramientas

1. Crear Video de Lipsync por Audio (`create_lipsync_video_by_audio`)

Cree un video de lipsync con entrada de audio. Anima un avatar humano digital para que hable en sincronía con el audio proporcionado.

Parámetros:

avatar: ID del avatar humano digital. Se debe proporcionar este o los parámetros de creación de avatar.
avatar_video_url: URL de un video para crear el avatar.
avatar_image_url: URL de una imagen para crear el avatar.
avatar_video_file: Ruta local a un archivo de video para crear el avatar.
avatar_image_file: Ruta local a un archivo de imagen para crear el avatar.
audio_url: URL remota del archivo de audio. Se debe proporcionar audio_url o audio_file.
audio_file: Ruta local al archivo de audio. Se debe proporcionar audio_url o audio_file.
title: Título opcional para el video creado.
async_mode: Si es verdadero, devuelve task_id inmediatamente. Si es falso, espera a que se complete y descarga el video. El valor predeterminado es verdadero.
output_path: Dónde guardar el video descargado si async_mode es falso. El valor predeterminado es "output.mp4".

Notas:

Para la creación de avatar, proporcione exactamente UNO de avatar_video_url, avatar_image_url, avatar_video_file o avatar_image_file.
Si se proporciona directamente el ID del avatar, estos parámetros se ignorarán.

Devuelve:

Si async_mode es verdadero: task_id para verificar el estado más tarde y created_avatar (si se creó un nuevo avatar)
Si async_mode es falso: ruta del video descargado, resultado de la tarea y created_avatar (si corresponde)

2. Crear Video de Lipsync por Texto (`create_lipsync_video_by_text`)

Cree un video de lipsync con entrada de texto. Genera audio a partir del texto y anima un avatar humano digital para que lo hable.