Skip to main content
Glama

flow-mcp — Google Flow MCP Server

Автономный MCP-сервер для Google Flow (выделен из media-gen-mcp): генерация изображений ИИ за 0 кредитов + платная генерация видео (Veo / abra), всё работает через сессию вашего локального Chrome (контекст страницы CDP) — без API-ключей, без квот, без сторонних прокси.

  • Генерация изображений / увеличение изображений / загрузка / проверка статуса / скачивание / удаление / публикация / отмена / сущности персонажей: всё за 0 кредитов

  • Генерация видео: расходует кредиты Google Flow (abra 7–20 / veo lite 10 / fast 20 / quality 100 за штуку; апскейл 1080p — 0) — в описании инструмента есть явное предупреждение, по умолчанию используется только по прямому запросу пользователя

Установка

Предварительные шаги (однократно):

  1. Установите локально lasso (запускатор Chrome в составе CC-интерактивного захвата)

  2. Запустите Chrome с CDP и войдите в labs.google:

lasso launch-chrome --port 9223 --mode visible   # 首次:窗口出现,完成 Google 登录(2FA 同)
# 之后每天只需:hidden 模式静默驻留
lasso launch-chrome --port 9223
  1. В этом Chrome откройте любую страницу проекта https://labs.google/fx/tools/flow (держите запущенной)

Подключение к Claude Code:

claude mcp add flow-mcp -- node /path/to/flow-mcp/dist/index.js
# 或发布后:npx flow-mcp-server

Можно подключать одновременно с media-gen-mcp, конфликтов нет (см. раздел «Сосуществование с media-gen-mcp» ниже).

Related MCP server: Grok Image Generation MCP Server

Инструменты (4 шт.)

Инструмент

Кредиты

Назначение

flow_generate_image

0

Текст-в-изображение / изображение-в-изображение (базовое + референсное) / апскейл 2K. NARWHAL (Nano Banana 2, по умолчанию) / HARBOR_SEAL / GEM_PIX_2 (Nano Banana Pro). Поддержка aspect (16:9/9:16/1:1/3:4/4:3) и seed для точного воспроизведения

flow_generate_video

🔴 платно

Отправка видео (t2v/i2v/r2v/первый-последний кадр/продление/редактирование/апскейл). Только отправка без ожидания, сразу возвращает дескриптор mediaId

flow_status

0

Всё-в-одном самоанализ: баланс кредитов / актуальный каталог моделей (цена в кредитах и время для каждого ключа) / список медиа / статус и скачивание отдельного медиа / массовое удаление / публичная ссылка для шаринга / отмена задач в процессе генерации. Также путь опроса дескрипторов видео

flow_entity

0

Сущности персонажей: создание карточки персонажа / привязка одного из 30 предустановленных голосов / привязка изображения персонажа

Типичный процесс:

flow_status                                    # 先看:余额 + 目录(per-key creditsAtServiceTier)
flow_generate_image(prompt=..., aspect="16:9") # 0 积分生图,产出落盘并回传 mediaId+seed
flow_generate_video(model="abra_t2v_8s", ...)  # 🔴 计费提交 → 返回 mediaId 句柄(不阻塞)
flow_status(mediaId="...")                     # 轮询(0 积分;in_progress 会给 retry_after_seconds)
flow_status(mediaId="...", download=true)      # completed 后落盘 mp4

Конфигурация (общий файл с media-gen-mcp)

Файл конфигурации: ~/.media-gen-mcp/config.json (оба пакета читают один и тот же файл — «разные каналы реализации одной функции» включаются/выключаются в одном файле). Имя каталога сохранено историческое, не меняйте (ID проекта Flow навсегда записан в ~/.media-gen-mcp/flow-project.json; переименование осиротит его).

{
  "flow": {
    "enabled": true,
    "imageRouting": "prefer",
    "videoRouting": "explicit-only",
    "toolDeadlineMs": 110000
  },
  "providers": {
    "flow": { "cdpPort": 9223 }
  }
}

Поле

По умолчанию

Назначение

flow.enabled

true

false = шлюз S000: 4 инструмента по-прежнему регистрируются, но вызов сразу возвращает структурированную ошибку [flow] S000 (с инструкцией по исправлению). После изменения конфига требуется перезапуск сессии

flow.imageRouting

"prefer"

prefer = в описание инструмента генерации изображений внедряется подсказка «приоритет 0 кредитов» (мягкая маршрутизация); on-demand = только когда пользователь явно называет Flow

flow.videoRouting

"explicit-only"

explicit-only (красная линия по кредитам) = видеоинструмент используется только при явном запросе Flow/Veo/abra; prefer = как предпочтительный (с предупреждением о платности)

flow.toolDeadlineMs

110000

Жёсткий верхний предел одного вызова инструмента (защита от зависания; по таймауту возвращается [flow] S410, генерация продолжается на сервере, можно найти через flow_status)

providers.flow.cdpPort

9223

Порт CDP (совпадает с lasso launch-chrome --port)

providers.flow.projectId

(по умолчанию)

По умолчанию читается постоянный проект из flow-project.json (рекомендуется — ID проекта переиспользуется навсегда)

providers.flow.models.video.default

(нет)

Намеренно нет встроенного значения по умолчанию: видео платное, нужно явно передавать model или явно настроить здесь

Полный пример см. в config.example.json.

Сосуществование с media-gen-mcp

  • Оба пакета разделяют ~/.media-gen-mcp/config.json; собственная цепочка imageProviderPriority / videoProviderPriority у media-gen действует только внутри его пакета

  • Приоритет между пакетами после разделения = мягкая маршрутизация через описание инструмента этого пакета (imageRouting/videoRouting направляют Claude выбирать flow_generate_image в первую очередь) + общий рубильник enabled — жёсткого перенаправления между пакетами не существует (физически пакеты не видят друг друга, честный дизайн)

  • flow-project.json / flow-entities.json принадлежат этому пакету; сторона media-gen после удаления Flow больше их не читает и не пишет

Справочник кодов ошибок ([flow] S<code>)

Код

Значение

Действие

S000

Конфигурация отключена

Следуйте инструкции в ошибке: верните flow.enabled в true, перезапустите сессию

S100

CDP недоступен

lasso launch-chrome --port 9223

S101

Нет страницы labs.google

Откройте страницу проекта Flow в этом Chrome

S102

Не выполнен вход

Завершите вход в labs.google в этом Chrome

S104

Ошибка reCAPTCHA

Останьтесь на странице Flow и повторите

S1xx остальные

Предварительные условия окружения

Повторите после готовности окружения; генерацию изображений можно перенаправить на другие инструменты

S2xx

Ошибка fetch страницы

Смотрите фрагмент ответа вышестоящего сервиса в message

S300/S301/S303

Проверка модели/параметров/режима

Следуйте указаниям в message: смените ключ или параметры (перехват до отправки, нулевой расход)

S400

mediaId не в этом проекте

Вызовите flow_status без параметров, чтобы увидеть все медиа

S402

Неполное скачивание

Просто повторите попытку

S410

Дедлайн на уровне инструмента (защита от зависания)

Генерация всё ещё идёт на сервере; найдите через flow_status без параметров

Требования к окружению

  • Node.js ≥ 18

  • Локальный Chrome (запущен через lasso с --remote-debugging-port=9223) с выполненным входом в labs.google

  • FFmpeg поставляется вместе с пакетом (ffmpeg-static; используется только для самопроверки корректности артефактов, при отсутствии автоматически деградирует до уведомления)

Лицензия

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.

  • Image, video, audio, face-swap, talking avatars and chat across 300+ AI models, one balance.

  • Generate images, video & speech with Nano Banana, Veo, Omni and Gemini TTS. Pay as you go.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/wangdong233/flow-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server