gflow-cli MCP Server

社区

从命令行或 AI 代理驱动 Google Flow 的 Veo 视频与 Imagen 图像生成。

★ 203 Stars 分类 · 其他非常热门

36FMRS · D

gflow-cli 为已有 Google Flow 访问权限的用户，提供了一个脚本化、可批量、可接入代理的 Flow 生成入口，并自带 MCP 服务器以便编码代理调用。它明确标注 alpha、逆向工程且与 Google 无关联，依赖有头 Chromium 与真实账号会话，视频生成会消耗用户自己的额度。适合能接受这些风险与限制的高级用户，不适合寻求官方支持或纯无头服务端部署的场景。

可靠性

6/20

安全与权限

8/20

维护活跃度

7/20

文档质量

10/20

安装易用性

5/20

查看 FMRS 评分方法 →

gflow-cli 是一个面向 Google Flow 的 Python 命令行工具与 MCP 服务器。它通过 MCP 服务器让编码代理（例如 Claude Code）也能驱动 Flow，从而对 Veo 视频生成（文生视频、图生视频、参考生视频、延长与串联）以及 Imagen 图像生成（文生图、图生图、上传、放大、批量）实施程序化控制。该工具处于 alpha 阶段，属逆向工程成果，与 Google 无隶属关系，并且只覆盖其自身代码的 MIT 许可，不授予任何 Google 服务的权利。它在用户自己的 Google Flow 会话上运行有头（headed）Playwright Chromium，并绑定用户自己的账号计费，其中只有 Veo 视频生成会消耗额度，图像与合成操作不计费。

安装接入

确认已具备可访问 Google Flow 的 Google 账号；2. 使用 uv 安装：uv tool install gflow-cli（或 pip install gflow-cli）；3. 一次性安装浏览器依赖：uv tool run --from gflow-cli playwright install chromium（约 150 MB）；4. 一次性登录：gflow auth login --browser chrome（会打开真实 Chrome 窗口）；5. 使用 gflow credits user 查看额度；6. 注册 MCP 服务器：uvx gflow-cli mcp run，如需禁止消耗额度的工具可加 --no-spend；7. 可选：设置 GFLOW_CLI_HOME 指定 Chrome 配置文件、配置与数据库目录，设置 GFLOW_CLI_OUTPUT_DIR 指定输出目录。

claude_desktop_config.json

{"mcpServers":{"gflow-cli":{"command":"uvx","args":["gflow-cli","mcp","run"],"env":{"GFLOW_CLI_HOME":""}}}}

生成并校验客户端配置

选型与风险

适合谁

需要脚本化、批量或流水线式 Flow 生成的重度用户
希望为代理提供 Flow 生成能力的自动化与 AI 视频项目
在中国境外拥有 Google Flow 访问权限与 Veo 额度的开发者

不适合谁

期望官方 Google 支持或官方接口的用户
无法接受账号自动化风险、不接受消耗自己 Flow 额度的用户
需要无头（headless）纯 HTTP 或服务端无浏览器部署的用户
希望把该工具用于 Google 服务之外的再分发或转售的用户

所需权限

需要用户本人已登录的 Google Flow 会话与账号凭证
会在本地持久化 Playwright Chromium 配置文件（默认位于每用户目录，可用 GFLOW_CLI_HOME 指定）
会写入生成结果到本地输出目录（或经 GFLOW_CLI_STORAGE_URI 写入 S3、MinIO、Google Cloud Storage）
会访问 Google 私有 Flow 接口（aisandbox-pa.googleapis.com 或迁移后的 batchexecute 接口）
视频生成会消耗该账号的 Flow 额度

风险与副作用

该工具为 alpha 阶段、逆向工程实现，与 Google 无隶属关系，可能随时因 Google 端点或界面变化而失效
自动化受 Google 服务条款约束，存在账号被标记的风险（项目未使用代理、不伪造指纹、也不伪装非自动化）
视频生成会消耗真实额度；界面漂移时 CLI 会快速失败（如选择器漂移退出码 23）以避免重复提交
该 MIT 许可仅覆盖其代码，不授予 Flow、Veo 输出或任何 Google 服务的权利
从本地检出安装时若未锁定 Playwright 版本，可能引入未测试的浏览器驱动并静默卡死生成流程

常见排障

确认已完成 gflow auth login --browser chrome，并建议始终使用 --browser chrome 以标记真实 Chrome 配置文件
首次调用需 30 到 90 秒等待 Chromium 预热，后续调用会复用热会话，请勿据此判定失败
检查 gflow credits user 的额度余额，确认视频生成有可用额度
如从本地检出安装，请显式锁定 Playwright 版本：uv tool install --force --with playwright==1.59.0 .
若选择器漂移导致退出码 23，请参考 KNOWN_ISSUES 与文档；批量项在提交前已本地记录，不会静默消耗额度
多账号或输出/存储路由问题请查阅 docs/CONFIGURATION.md 与 docs/EXTERNAL_STORAGE.md

使用场景

在自动化流水线中批量生成 Veo 视频与 Imagen 图像

让编码代理（Claude Code 等）通过 MCP 调用 Flow 生成能力

用 gflow character 生成可复用的角色主体，保持跨次生成主体一致

用 --tool creative-director 等提示词工具在生成前重写提示词

用 gflow video extend 延长既有片段以突破 Flow 的 8 秒时限

支持客户端

Claude Code部分支持