Skip to main content
Glama

flow-mcp — Google Flow MCP Server

Eigenständiger MCP-Server für Google Flow (aus media-gen-mcp ausgegliedert): KI-Bildgenerierung mit 0 Credits + kostenpflichtige Videogenerierung (Veo / abra), alles gesteuert über deine lokale Chrome-Sitzung (CDP-Seitenkontext) — kein API-Key, keine Kontingente, keine Drittanbieter-Weiterleitung.

  • Bildgenerierung / Bildvergrößerung / Upload / Statusabfrage / Download / Löschen / Teilen / Abbrechen / Rollen-Entitäten: alles 0 Credits

  • Videogenerierung: verbraucht Google-Flow-Credits (abra 7–20 / veo lite 10 / fast 20 / quality 100 pro Video; 1080p-Upscaling 0) — in der Tool-Beschreibung explizit gewarnt, standardmäßig nur auf ausdrücklichen Wunsch des Nutzers verwendet

Installation

Voraussetzungen (einmalig):

  1. Lokal lasso installieren (Chrome-Launcher aus dem CC-Interaktions-Handbuch)

  2. Chrome mit CDP starten und bei labs.google anmelden:

lasso launch-chrome --port 9223 --mode visible   # 首次:窗口出现,完成 Google 登录(2FA 同)
# 之后每天只需:hidden 模式静默驻留
lasso launch-chrome --port 9223
  1. In diesem Chrome eine beliebige Projektseite unter https://labs.google/fx/tools/flow öffnen (laufen lassen)

Anbindung an Claude Code:

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

Kann gleichzeitig mit media-gen-mcp angebunden werden, ohne Konflikte (siehe unten „Koexistenz mit media-gen-mcp").

Related MCP server: Grok Image Generation MCP Server

Tools (4)

Tool

Credits

Zweck

flow_generate_image

0

Text-zu-Bild / Bild-zu-Bild (Basisbild + Referenzbild) / 2K-Vergrößerung. NARWHAL (Nano Banana 2, Standard) / HARBOR_SEAL / GEM_PIX_2 (Nano Banana Pro). Unterstützt aspect (16:9/9:16/1:1/3:4/4:3) und seed für exakte Reproduktion

flow_generate_video

🔴 kostenpflichtig

Video-Submission (t2v/i2v/r2v/Erst- und Endframe/Verlängerung/Bearbeitung/Upscaling). Nur Submission, kein Warten — gibt sofort mediaId-Handle zurück

flow_status

0

All-in-one-Introspektion: Credit-Guthaben / Live-Modellkatalog (Credit-Preis und Dauer pro Key) / Medienliste / Einzelmedien-Status und Download / Massenlöschung / öffentlicher Freigabe-Link / Abbruch laufender Generierungen. Auch der Polling-Pfad für Video-Handles

flow_entity

0

Rollen-Entitäten: Rollenkarte erstellen / 1 von 30 voreingestellten Stimmen binden / Charakterbild binden

Typischer Ablauf:

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

Konfiguration (teilt sich eine Datei mit media-gen-mcp)

Konfigurationsdatei: ~/.media-gen-mcp/config.json (beide Pakete lesen dieselbe Datei — „verschiedene Implementierungskanäle derselben Funktion" werden in einer Datei einheitlich ein-/ausgeschaltet). Der Verzeichnisname folgt dem historischen Namen, nicht ändern (die Flow-Projekt-ID wird dauerhaft in ~/.media-gen-mcp/flow-project.json gespeichert; eine Umbenennung würde das Projekt verwaist zurücklassen).

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

Feld

Standard

Wirkung

flow.enabled

true

false = S000-Zugangskontrolle: Die 4 Tools bleiben registriert, aber jeder Aufruf gibt sofort einen strukturierten [flow] S000-Fehler zurück (mit Selbstreparatur-Anleitung). Nach Konfigurationsänderung Sitzung neu starten

flow.imageRouting

"prefer"

prefer = Die Bildgenerierungs-Tool-Beschreibung erhält einen „0-Credits-bevorzugt"-Hinweis (Soft-Routing); on-demand = nur wenn der Nutzer Flow explizit nennt

flow.videoRouting

"explicit-only"

explicit-only (Credit-Rotlinie) = Video-Tools nur bei expliziter Anforderung von Flow/Veo/abra durch den Nutzer; prefer = als erste Wahl (weiterhin mit Kostenwarnung)

flow.toolDeadlineMs

110000

Harte Obergrenze für einzelne Tool-Aufrufe (verhindert Hänger; bei Timeout Rückgabe von [flow] S410, die Generierung läuft serverseitig weiter und kann über flow_status wiederhergestellt werden)

providers.flow.cdpPort

9223

CDP-Port (übereinstimmend mit lasso launch-chrome --port)

providers.flow.projectId

(fehlt)

Bei Fehlen wird das permanente Projekt aus flow-project.json gelesen (empfohlen — Projekt-ID wird dauerhaft wiederverwendet)

providers.flow.models.video.default

(keines)

Bewusst keine eingebaute Standardeinstellung: Video ist kostenpflichtig, model muss explizit übergeben oder hier explizit konfiguriert werden

Vollständiges Beispiel siehe config.example.json.

Koexistenz mit media-gen-mcp

  • Beide Pakete teilen ~/.media-gen-mcp/config.json; die eigene imageProviderPriority- / videoProviderPriority-Kette von media-gen wirkt nur innerhalb dieses Pakets

  • Die paketübergreifende Priorität nach der Trennung = Soft-Routing über die Tool-Beschreibungen dieses Pakets (imageRouting/videoRouting leiten Claude dazu, flow_generate_image zu bevorzugen) + enabled als Hauptschalter — es gibt keine paketübergreifende harte Umleitung (die beiden Pakete sind physisch gegenseitig unsichtbar, ehrliches Design)

  • flow-project.json / flow-entities.json gehören zu diesem Paket; die media-gen-Seite liest/schreibt sie nach Entfernen von Flow nicht mehr

Fehlercode-Schnellreferenz ([flow] S<code>)

Code

Bedeutung

Behandlung

S000

Konfiguration deaktiviert

flow.enabled gemäß Anleitung im Fehler auf true zurücksetzen, Sitzung neu starten

S100

CDP nicht erreichbar

lasso launch-chrome --port 9223

S101

Keine labs.google-Seite

Flow-Projektseite in diesem Chrome öffnen

S102

Nicht angemeldet

labs.google-Anmeldung in diesem Chrome abschließen

S104

reCAPTCHA fehlgeschlagen

Auf der Flow-Seite bleiben und erneut versuchen

S1xx übrige

Umgebungsvoraussetzungen

Nach Bereitschaft der Umgebung erneut versuchen; Bildgenerierung kann auf andere Bild-Tools ausweichen

S2xx

Seiten-fetch fehlgeschlagen

Antwortfragment im message-Feld ansehen

S300/S301/S303

Modell-/Parameter-/Modus-Validierung

Key oder Parameter gemäß message-Anleitung wechseln (vor der Submission abgefangen, null Verbrauch)

S400

mediaId nicht in diesem Projekt

flow_status ohne Parameter aufrufen, um alle Medien anzuzeigen

S402

Download unvollständig

Direkt erneut versuchen

S410

Tool-Ebene abgelaufen (verhindert Hänger)

Generierung läuft weiterhin serverseitig; flow_status ohne Parameter zum Wiederherstellen aufrufen

Umgebungsanforderungen

  • Node.js ≥ 18

  • Lokales Chrome (über lasso mit --remote-debugging-port=9223 gestartet) und bei labs.google angemeldet

  • FFmpeg im Paket enthalten (ffmpeg-static; nur für die Integritätsprüfung der Artefakte, bei Fehlen automatische Degradierung auf Hinweis)

Lizenz

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