Skip to main content
Glama

fal-video-mcp

Локальный MCP-сервер, оборачивающий очередь fal.ai (https://docs.fal.ai/model-endpoints/queue). Даёт Claude Code инструменты: запустить генерацию, проверить статус, дождаться результата, отменить job и скачать готовый файл (видео/картинку/аудио) на диск.

1. Получите ключ

Зарегистрируйтесь на https://fal.ai, создайте API-ключ в Dashboard → Keys.

Related MCP server: Fal.ai MCP Server

2. Подключите сервер к Claude Code

В терминале (не в этой сессии — она не интерактивна):

claude mcp add fal-video --env FAL_KEY=ВАШ_КЛЮЧ -- node "C:\code\mcp\fal-video-mcp\server.js"

Ключ хранится в конфиге Claude Code локально на вашей машине и передаётся серверу только как переменная окружения — сам сервер его никуда не отправляет, кроме заголовка Authorization в запросах к queue.fal.run.

Проверить, что подключилось:

claude mcp list

3. Инструменты

  • fal_submit_job(model_id, input) — отправить job в очередь, вернуть request_id.

  • fal_check_status(model_id, request_id) — статус (IN_QUEUE / IN_PROGRESS / COMPLETED).

  • fal_get_result(model_id, request_id) — забрать готовый результат.

  • fal_wait_for_result(model_id, input) — отправить и дождаться результата одним вызовом (проще всего).

  • fal_cancel_job(model_id, request_id) — отменить.

  • fal_download_file(url, dest_path) — скачать медиа-файл с fal.media на диск (ссылки истекают).

4. Примеры model_id для видео

  • fal-ai/minimax/h3-max/text-to-video — текст → видео

  • fal-ai/kling-video/v3/pro/image-to-video — картинка → видео (кино-качество)

  • fal-ai/bytedance/seedance-2.5/image-to-video — картинка → видео до 30 сек, 720p

  • fal-ai/bytedance/seedance-2.5/reference-to-video — несколько референсов → видео

Точные поля input смотрите на странице модели на fal.ai (кнопка "See docs"), они разные для каждой модели (prompt, image_url, duration, aspect_ratio и т.д.).

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables Claude Desktop and other MCP clients to generate images, videos, music, and audio using Fal.ai models. Supports text-to-image generation, video creation, music composition, text-to-speech, audio transcription, and image enhancement through natural language prompts.
    18
    56
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables interaction with fal.ai AI models through MCP, supporting model discovery, content generation, queue management, and file uploads to the fal.ai platform.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides access to over 600 AI models on fal.ai for generating and editing images, videos, music, and speech directly within Claude. It supports high-performance models like FLUX, Kling, and Whisper for various creative and analytical tasks.
    785 npm
    1
    MIT