Flyworks MCP

Um servidor para criar vídeos de lipsync rápidos e gratuitos para avatares digitais, suportando estilos realistas e cartoon.

GitHub

Experimente este MCPPatrocinado

Documentação

Flyworks MCP: Ferramenta Gratuita e Rápida de Lipsync Zeroshot

Visão Geral

O Flyworks MCP é um servidor Model Context Protocol (MCP) que fornece uma interface conveniente para interagir com a API Flyworks. Ele facilita a criação rápida e gratuita de vídeos de lipsync para uma ampla variedade de avatares digitais, incluindo estilos realistas e cartoon.

Demonstração

Vídeo de avatar de entrada (filmagem):

Clipe de áudio com TTS dizendo 我是一个飞影数字人。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.:

Vídeo de lipsync gerado:

Recursos

Crie vídeos com lipsync usando vídeo de avatar digital e áudio como entradas
Crie vídeos com lipsync por texto (com conversão de texto em fala)
Crie avatares humanos digitais a partir de imagens ou vídeos
Suporte para modos de operação assíncrono e síncrono
Mais recursos em breve...

Requisitos

Python 3.8+
Dependências: httpx, mcp[cli]

Uso

Integração com Claude ou Outros Clientes MCP

Usando no Claude Desktop

Vá para Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir o seguinte:

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

Usando no Cursor

Vá para Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server para adicionar a configuração acima.

Certifique-se de substituir your_api_token_here pelo seu token de API real e atualize o FLYWORKS_MCP_BASE_PATH para um diretório válido no seu sistema onde os arquivos de saída serão salvos.

Nota: Oferecemos acesso de teste gratuito à nossa ferramenta com o token 2aeda3bcefac46a3. No entanto, esteja ciente de que a cota diária para este acesso gratuito é limitada. Além disso, os vídeos gerados terão marca d'água e serão restritos a uma duração de 45 segundos. Para acesso completo, entre em contato conosco em bd@flyworks.ai para adquirir seu token.

Instalando via Smithery

Para instalar o flyworks-mcp para Claude Desktop automaticamente via Smithery:

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

Instalação local

Clone este repositório:

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

Instale as dependências:
```
pip install httpx "mcp[cli]>=1.6.0"
```
Ou usando uv:
```
uv pip install httpx "mcp[cli]>=1.6.0"
```
Para evitar problemas de tempo limite durante a inicialização do servidor, recomendamos pré-instalar todas as dependências:
```
pip install pygments pydantic-core httpx "mcp[cli]>=1.6.0"
```
Configuração

Defina seu token de API Flyworks como uma variável de ambiente:

# 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, você pode criar um arquivo .env.

Executando o Servidor

Execute o arquivo server.py diretamente:

python server.py

Problema de spawn uvx ENOENT:

Confirme o caminho absoluto executando este comando no seu terminal:

which uvx

Depois de obter o caminho absoluto (por exemplo, /usr/local/bin/uvx), atualize sua configuração para usar esse caminho (por exemplo, "command": "/usr/local/bin/uvx").

Descrição das Ferramentas

1. Criar Vídeo de Lipsync por Áudio (`create_lipsync_video_by_audio`)

Crie um vídeo de lipsync com entrada de áudio. Anima um avatar humano digital para falar em sincronia com o áudio fornecido.

Parâmetros:

avatar: ID do avatar humano digital. Deve ser fornecido este ou os parâmetros de criação de avatar.
avatar_video_url: URL de um vídeo para criar o avatar.
avatar_image_url: URL de uma imagem para criar o avatar.
avatar_video_file: Caminho local para um arquivo de vídeo para criar o avatar.
avatar_image_file: Caminho local para um arquivo de imagem para criar o avatar.
audio_url: URL remota do arquivo de áudio. Um de audio_url ou audio_file deve ser fornecido.
audio_file: Caminho local para o arquivo de áudio. Um de audio_url ou audio_file deve ser fornecido.
title: Título opcional para o vídeo criado.
async_mode: Se verdadeiro, retorna task_id imediatamente. Se falso, aguarda a conclusão e baixa o vídeo. O padrão é verdadeiro.
output_path: Onde salvar o vídeo baixado se async_mode for falso. O padrão é "output.mp4".

Notas:

Para criação de avatar, forneça exatamente UM de avatar_video_url, avatar_image_url, avatar_video_file ou avatar_image_file.
Se o ID do avatar for fornecido diretamente, esses parâmetros serão ignorados.

Retornos:

Se async_mode for verdadeiro: task_id para verificar o status posteriormente e created_avatar (se um novo avatar foi criado)
Se async_mode for falso: caminho do vídeo baixado, resultado da tarefa e created_avatar (se aplicável)

2. Criar Vídeo de Lipsync por Texto (`create_lipsync_video_by_text`)

Crie um vídeo de lipsync com entrada de texto. Gera áudio a partir do texto e anima um avatar humano digital para falá-lo.