内容
# google-flow-mcp
MCP 服务器通过浏览器自动化，在 [Google Flow](https://labs.google/flow) 上生成 **图片和视频**，
这样您可以使用自己的 **Google AI Pro** 订阅服务，而不是按信用额度付费的服务。 该软件包自带 Claude Code 技能。
已验证端到端：图片（Nano Banana / Imagen）和视频（Veo 3.1 / Omni Flash）在实际 Flow 项目中生成并下载到磁盘。
> 适应并强化了当前的 agent-first Flow UI（和 Windows），源自
> [TMSSS05/google-flow-browser-mcp](https://github.com/TMSSS05/google-flow-browser-mcp)。
## 功能
Playwright 通过 Chrome DevTools 协议连接到专用的 Chrome 浏览器，该浏览器已登录到您的 Google 账户。
它驱动 Flow 的 agent 生成媒体，并通过身份验证的会话下载结果。**无需 API 密钥，无需密码处理** —
它使用您现有的浏览器会话。
工具（17）：`flow_connect`、`flow_status`、`flow_account_check`、`flow_discover_ui`、
`flow_generate_image`、`flow_generate_video`、`flow_download_latest`、字符/场景工具、
`flow_use_grid_architect`、`flow_screenshot`、`flow_queue_status`、…
## ⚠️ 服务条款
这是 **非官方的浏览器自动化**。Flow 没有官方的 Google API。
启动器直接启动 Chrome 浏览器，因此 `navigator.webdriver` 为 false，这是一个明确的反机器人措施。
自动化 Google 属性可能会违反 Google 的服务条款，并可能使您的账户面临风险。**请自担风险，在您自己的账户上使用。**
## 要求
- Node.js ≥ 18
- Google Chrome 浏览器（Chrome 149+ 需要 Playwright ≥ 1.61.1，已经固定）
- 具有 Flow 访问权限的 Google 账户（建议使用 Google AI Pro）
## 设置
```bash
npm install
cp config/flow.config.example.json config/flow.config.json
# 编辑 config/flow.config.json → 设置 expectedAccount 和 chromeUserDataDir
```
启动专用的 Chrome 浏览器（幂等 — 仅在需要时启动）：
```powershell
powershell -File scripts/ensure-flow-chrome.ps1
```
首次运行：在该 Chrome 浏览器窗口中，登录到您的 Google 账户 **并** 点击
**"登录到 Flow"** 在 labs.google 上（Flow 使用单独的登录）。会话保存在专用配置文件中并被重用。
使用您的 MCP 客户端（Claude Code 等）注册服务器：
```json
{
"mcpServers": {
"google-flow": { "type": "stdio", "command": "node", "args": ["<path>/src/index.js"] }
}
}
```
重启客户端后（服务器在启动时加载到内存中）。
## 重要注意事项
- **图片实际上是免费的**，与每月 Flow 信用额度池相对；**视频会消耗信用额度**
（Veo 3.1 Lite ~10，Fast ~20，Quality ~100；Omni Flash ~15-30 of ~1000/月）。视频显示信用额度确认对话框，服务器会批准。
- **模型/持续时间必须是一个有效的组合**，否则 Flow 的 agent 会要求澄清，并且不会生成任何内容
（例如，Veo 3.1 Lite 在 Pro 计划上仅限 8 秒；Omni Flash 4-10 秒）。
- Flow 是 **agent-first**：提示被命令式包装，因此 agent 直接生成内容，而不是提出问题。
- UI 语言遵循您的 Google 账户；导航选择器涵盖 IT/FR/EN。
## Claude Code 技能
`skill/SKILL.md` 是一个现成的技能：将它放入 `~/.claude/skills/google-flow-generate/`
中，Claude 将自动选择正确的工具，处理 Chrome 浏览器启动和回退。
## 许可证
MIT — 请参阅 [LICENSE](./LICENSE)。
