# fal-video-mcp

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

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

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

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

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

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

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

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

```bash
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 и т.д.).