gflow-cli MCP Server

社区

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

分类: 其他第 204 / 230
Stars: ★ 354 非常热门
传输方式: stdio（本地进程）
运行环境: Python · 预编译二进制
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 1 天前

36FMRS · D

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

最强项 · 文档质量 10/20 最弱项 · 安装易用性 5/20

可靠性

6/20

安全与权限

8/20

维护活跃度

7/20

文档质量

10/20

安装易用性

5/20

查看各项评分依据

可靠性 6/20: 作为静态评审，只能在所提供的 README 与 server.json 内取证据。好处是：README 明确承认 alpha 状态、反复出现已知缺陷清单（KNOWN_ISSUES）、区分退出码（如 selector drift = exit 23），并声称有每版本 LIVE_VERIFICATION 证据与 CI 徽章；Manifest 版本号 0.78.0 与 README 描述一致，工具入口 `gflow mcp run` / `gflow serve` 自洽。但静态证据严重不足：所有『已验证/生产稳定』的说法都来自 README 自述，属不可信来源，没有可见的已提交测试覆盖 MCP 服务器关键路径，未见实际 CI 工作流文件内容，未见 server.json 之外的 tool 清单与其实现是否匹配。此外产品本体依赖有头 Playwright Chromium、Google 私有 API（aisandbox-pa）与 UI 自动化，明确表态会因 Google UI 变更而漂移，且自述 HTTP 传输被 401+reCAPTCHA 阻断——核心路径的可复现性对第三方不可验证。按静态校准上限 12，再对测试证据缺失与外部依赖脆弱性扣分，得 6。
安全与权限 8/20: 未见触犯红线的证据：无凭据窃取、无隐蔽外传、未在示例中内嵌真实 token、未发现伪装维护者身份。且项目在安全透明度上表现不错——明确声明使用用户自己的 Google 账号与额度、明确声明不做代理/指纹伪装、视频生成会消耗额度而图像免费、插件本体默认 disabled 且提供 `--no-spend` 模式来彻底不注册花钱工具，这些都属于负责任的最小权限与确认设计。扣分点：该服务器的本质是把用户的 Google 会话（持久化 Chrome 配置）交给自动化程序驱动，Manifest 只暴露 GFLOW_CLI_HOME 一个非密环境变量，但未在 manifest 层面声明任何确认/权限边界；文档也承认会把内容与请求发往 Google 私有 API 并可能路由到 S3/MinIO/GCS 存储，数据流披露靠 README 而非机器可读清单；此外『反检测节奏化提交』的账号操作在 Google ToS 下存在账号风险，虽然作者已诚实披露。综合给 8，未构成红线，但权限/确认的机器可读契约不完整。
维护活跃度 7/20: 证据面：MIT 许可证明确，版本号 0.78.0 表明迭代频繁（高频发版本身是活跃信号），Python/PyPI 发布路径与 `gflow update` 升级机制存在，徽章提到 CI、release、SonarCloud、OpenSSF Scorecard，并声称为每版本做真实 Flow 验证。但静态可见的治理仍有明显缺口：55 个 open issue 相对 203 star 偏高，文档自称由单人维护（bus factor=1），无可见的安全响应渠道/披露政策，无机器可读的依赖锁定保证（README 反而警告从本地 checkout 安装会忽略 uv.lock、可能装到未测试的 Playwright 版本），版本号 0.x 且自述 alpha，尚无『维护活跃度』的长周期证据可查。按 10（活跃但有治理/版本化缺口）向下取 7。
文档质量 10/20: 文档是本项目最强的维度，且属于可审查的分层结构：README 给出 60 秒快速开始（安装、`playwright install chromium`、`gflow auth login`、`credits user`、生成示例），并显式链接 USER_GUIDE/USAGE/CONFIGURATION/EXTERNAL_STORAGE/MCP/ARCHITECTURE/SECURITY/KNOWN_ISSUES/CHANGELOG 等；对成本与失败代价有具体说明（仅视频计费、退出码语义、批处理先落盘再提交）；对限制有罕见诚实的披露（有头浏览器依赖、纯 HTTP 传输被 401+reCAPTCHA 阻断、两套前端 labs/flow.google.com 迁移中、本地 checkout 安装的 Playwright 陷阱）；并声明 CLI↔MCP 有 CI 强制的参数对等契约。扣分点：以上均以 README 自述为准，静态无法核验其与实际 MCP tool 列表/参数是否一致；MCP 客户端配置示例放在被引用的 docs/MCP.md 内，本次未提供，因而『工具参数与接入配置』这一关键证据缺失；未直接写明每次生成的额度消耗量与速率限制的具体数值。按 10（可用但含隐藏假设与排障缺口）为本维度基准。
安装易用性 5/20: 安装路径本身清晰：唯一包为 PyPI 的 gflow-cli，runtimeHint 为 uvx，传输 stdio，packageArguments 为 `mcp` + `run`，另有 `gflow serve` 走 Streamable HTTP；README 给出一行 `uv tool install gflow-cli` 与 `uvx` 用法，并说明镜像/多平台（含 Windows 录屏脚本）的兼容性方向。但静态证据下这条路径并不『少步骤且稳定』：必须先 `playwright install chromium`（约 150MB 额外下载），必须先 `gflow auth login --browser chrome` 打开真实 Chrome 完成登录与 reCAPTCHA（无法无头、无法在纯容器内生成，文档自述容器镜像只能自省不能生成），首次调用需 30–90 秒预热，README 还警告从本地 checkout 安装会解析到未测试的 Playwright 版本需手动钉版本。也就是说，从『准备运行时』到『主流客户端可用连接』之间仍依赖人工浏览器交互与大量外部前置条件，且本对象未提供客户端配置样例。按静态上限 15 再显著下调，得 5。

静态评测 · 未实际运行收录于 2026-09-18

查看 FMRS 评分方法 →

选型与风险

能访问什么写入 / 删除本地文件访问网络修改第三方账户数据控制浏览器

适合谁

需要脚本化、批量或流水线式 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 版本，可能引入未测试的浏览器驱动并静默卡死生成流程

安装接入

准备工作

运行环境：Python · 预编译二进制

其他可选配置项（4 个）

GFLOW_CLI_HOME 可选 gflow 存储 Chrome 配置、配置文件和数据库的目录，默认为用户级目录，非必需。

GFLOW_CLI_OUTPUT_DIR 可选生成输出文件的落地目录，非必需，也可用 GFLOW_CLI_STORAGE_URI 路由到外部存储。

GFLOW_CLI_STORAGE_URI 可选将输出路由到 S3、MinIO 或 Google Cloud Storage 的存储 URI，见 docs/EXTERNAL_STORAGE.md。

GFLOW_CLI_FLOW_HOST 可选选择 Flow 前端主机（labs.google 或 flow.google.com），用于迁移中的驱动切换，非必需。

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

.mcp.json

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

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add gflow-cli -e GFLOW_CLI_HOME= -- uvx gflow-cli mcp run

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置 gflow-cli MCP 服务器并启用插件后，连接工具列表应出现 gflow 的图像/视频生成等工具；可先运行 `gflow credits user` 或用免费的照片生成提示验证连通，视频生成会消耗账户额度。

常见排障

确认已完成 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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

帮我用 Google Flow 生成一张热气球飞过东京日出上空的图片
生成一段 16:9 的阳光森林缓推镜头视频
查一下我当前 Flow 账户的剩余额度
创建一个可复用的人物角色，用于后续多次生成

使用场景

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

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

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

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

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

支持客户端

Claude Code部分支持

依据项目文档列出，未经本站实测。

详细介绍

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