Skip to main content
Glama

flow-mcp — Google Flow MCP Server

Google Flow のスタンドアロン MCP サーバー(media-gen-mcp から分離):0 クレジット AI 画像生成 + 課金制動画生成(Veo / abra)、すべてお使いのローカル Chrome セッション(CDP ページコンテキスト)経由で駆動 —— API キー不要、割り当てなし、第三者転送なし。

  • 画像生成 / 画像拡大 / アップロード / 状態照会 / ダウンロード / 削除 / 共有 / キャンセル / キャラクターエンティティ:すべて 0 クレジット

  • 動画生成:Google Flow クレジットを消費(abra 7〜20 / veo lite 10 / fast 20 / quality 100 件あたり;1080p 超解像 0)—— ツール説明に明示的に警告し、デフォルトではユーザーが明示的に指定した場合のみ使用

インストール

前提(一度だけ):

  1. ローカルに lasso をインストール(CC 全操作型ハンドラ内の Chrome ランチャー)

  2. CDP 付き Chrome を起動し 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 選 1 のプリセット音声バインド / キャラクター画像バインド

典型的なフロー:

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(両パッケージが同じファイルを読む —— 「同じ機能の異なる実装チャネル」を 1 つのファイルで一括オン/オフ)。ディレクトリ名は歴史的な名前を踏襲し、変更しないでください(Flow プロジェクト ID は ~/.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共有;media-gen 自身の imageProviderPriority / videoProviderPriority チェーンはそのパッケージ内でのみ有効

  • 分離後のクロスパッケージ優先度 = 本パッケージのツール説明ソフトルーティング(imageRouting/videoRouting が Claude を flow_generate_image 優先に誘導)+ enabled マスタースイッチ —— クロスパッケージのハードリダイレクトは存在しない(物理的に両パッケージは互いに不可視、誠実な設計)

  • flow-project.json / flow-entities.json は本パッケージの所有;media-gen 側は Flow を外した後は読み書きしない

エラーコード早見表([flow] S<code>)

コード

意味

対処

S000

設定で無効化されている

エラー内のガイドに従って flow.enabledtrue に戻し、セッションを再起動

S100

CDP に接続できない

lasso launch-chrome --port 9223

S101

labs.google のページがない

その Chrome で Flow プロジェクトページを開く

S102

未ログイン

その Chrome で labs.google にログイン

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;成果物の正当性自己チェックのみに使用、欠落時は自動的にヒントへダウングレード)

License

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