The Flyworks MCP is a Model Context Protocol (MCP) server that provides a convenient interface for interacting with the Flyworks API. It facilitates fast and free lipsync video creation for a wide range of digital avatars, including realistic and cartoon styles.
Input avatar video (footage):
Audio clip with 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.:
Generated lipsync video:
httpx, mcp[cli]uv:Set your Flyworks API token as an environment variable:
Alternatively, you can create a .env file.
Note: We offer free trial access to our tool with the token
2aeda3bcefac46a3. However, please be aware that the daily quota for this free access is limited. Additionally, the generated videos will be watermarked and restricted to a duration of 45 seconds. For full access, please contact us at bd@flyworks.ai to acquire your token.
Run the server.py file directly:
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server to add above config.
Make sure to replace your_api_token_here with your actual API token, and update the FLYWORKS_MCP_BASE_PATH to a valid directory on your system where output files will be saved.
Please confirm its absolute path by running this command in your terminal:
Once you obtain the absolute path (e.g., /usr/local/bin/uvx), update your configuration to use that path (e.g., "command": "/usr/local/bin/uvx").
create_lipsync_video_by_audio)Create a lipsync video with audio input. Animates a digital human avatar to speak in sync with the provided audio.
Parameters:
avatar: Digital human avatar ID. Either this or avatar creation parameters must be provided.avatar_video_url: URL of a video to create the avatar from.avatar_image_url: URL of an image to create the avatar from.avatar_video_file: Local path to a video file to create the avatar from.avatar_image_file: Local path to an image file to create the avatar from.audio_url: Remote URL of the audio file. One of audio_url or audio_file must be provided.audio_file: Local path to the audio file. One of audio_url or audio_file must be provided.title: Optional title for the created video.async_mode: If true, returns task_id immediately. If false, waits for completion and downloads the video. Default is true.output_path: Where to save the downloaded video if async_mode is false. Default is "output.mp4".Notes:
Returns:
create_lipsync_video_by_text)Create a lipsync video with text input. Generates audio from the text and animates a digital human avatar to speak it.
Parameters:
avatar: Digital human avatar ID. Either this or avatar creation parameters must be provided.avatar_video_url: URL of a video to create the avatar from.avatar_image_url: URL of an image to create the avatar from.avatar_video_file: Local path to a video file to create the avatar from.avatar_image_file: Local path to an image file to create the avatar from.text: Text content to be spoken by the avatar. Required.voice: Voice ID to use for text-to-speech. If not provided, a random voice will be selected automatically.title: Optional title for the created video.async_mode: If true, returns task_id immediately. If false, waits for completion and downloads the video. Default is true.output_path: Where to save the downloaded video if async_mode is false. Default is "output.mp4".Notes:
Returns:
For tasks run in async mode, you can check their status using the Flyworks API's /creation/task endpoint with the task_id returned by the tool.
This server cannot be installed
A Model Context Protocol server that enables fast and free lipsync video creation for a wide range of digital avatars, supporting both audio and text inputs to generate synchronized lip movements.