Google Flow MCP
Integrates with Google Flow (flow.google.com) using a logged-in Google account to generate and edit Nano Banana images, generate Omni Flash/Veo videos, create storyboards, upscale media, manage projects and media, and run budget-aware background jobs.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
google-flow-mcp
Google Flow için gelişmiş bir MCP sunucusu. Kendi Google hesabınla Nano Banana resimleri ve Omni Flash / Veo 3.1 videoları üretir. Streamable HTTP ile çalışır ve Obot üzerinde kapsayıcı olarak yayına alınmak için tasarlandı. Claude Code, Claude Desktop, Cursor ve stdio isteyen diğer istemcilerle de çalışır.
Resmî olmayan bir araçtır, Google ile bağlantısı yoktur. Flow'un herkese açık bir API'si yok. Bu sunucu senin oturumunla gerçek bir Chrome sekmesini kullanır. Google'ın şartları geçerlidir ve hesabın risk altında olabilir. Kendi hesabında ve sorumluluğunda kullan.
Neler yapıyor
Resim (ücretsiz): metinden resim, resimden resim, resim düzenleme, 1 ile 4 arası varyant, tek çağrıda 4'e kadar farklı prompt, tohum (seed), 5 en-boy oranı. Nano Banana Pro, 2.1 ve Lite.
Karakter tutarlılığı: önceki resimleri
reference_imagesolarak vererek aynı kişiyi, ürünü ya da stili koru.Video (kredi harcar): Omni Flash ile metinden video, ilk kareden video, ilk ve son kare arası video, referans resimlerden video (4, 6, 8, 10 saniye, 360p/720p). Veo 3.1 ile ilk kareden video.
Storyboard: her çekim için tutarlı bir kare üretir, istersen her kareyi canlandırır.
Büyütme: resimleri 2K veya 4K'ya büyütür.
Arka plan işleri: uzun videolar
job_iddöner,flow_waitile sonucu alırsın. İstemci zaman aşımına takılmazsın.Kredi koruması: video ancak
confirm=trueile gider.FLOW_BUDGET_CREDITSkesin bir tavandır ve aşılacaksa istek hiç gönderilmez.flow_estimate_video_costücretsizdir.Esnek resim girişi: Flow medya kimliği, https URL, data URI ya da base64. Gerekirse önce yüklenir.
Uzak çalışmaya hazır: Docker imajı, Obot katalog dosyası,
/healthz, isteğe bağlı Bearer token, SSRF koruması.
Diğer projelerle ayrıntılı karşılaştırma: docs/COMPARISON.md.
Related MCP server: Veo 3.1 MCP Server
Nasıl çalışıyor
MCP istemcisi ──Streamable HTTP──> google-flow-mcp ──page.evaluate──> Chrome (Xvfb, gerçek oturum) ──> flow.google.com
│ │
├─ iş kuyruğu ve kredi bütçesi └─ reCAPTCHA token'ı sayfada üretilir,
└─ batchexecute zarfları aynı anda batchexecute isteği gönderilirEylül 2026'dan beri Flow flow.google.com adresinde ve her çağrı tek bir batchexecute uç noktasına gidiyor. Üretim çağrıları yalnız gerçek Flow sayfasında üretilebilen, tek kullanımlık bir reCAPTCHA Enterprise token'ı istiyor. Google --headless Chrome'u bot sayıyor. Bu yüzden imaj, Xvfb sanal ekranında "başlı" çalışan gerçek Google Chrome kullanıyor. Oturum kalıcı bir profil yerine dışa aktarılmış çerez dosyasından geliyor. Böylece Obot'un geçici podlarında da çalışıyor.
Protokol katmanı crisng95/flowkit ve alarconcesar/flow-mcp projelerinin MIT lisanslı çalışmasından türetildi.
Hızlı başlangıç
1. Çerezleri dışa aktar
pipx install git+https://github.com/UmutKDev/google-flow-mcp
google-flow-mcp loginAçılan Chrome'da Google'a ve flow.google.com'a giriş yap. Komut ~/.google-flow-mcp/cookies.json dosyasını yazar. Cookie-Editor JSON'u ve cookies.txt de kabul edilir.
2a. Obot
Adım adım anlatım: docs/OBOT.md. Kısaca: bu repoyu Obot'a katalog kaynağı olarak ekle, obot/google-flow-mcp.yaml girdisi oluşur. Çerez dosyasını base64'e çevirip (base64 -w0 cookies.json) FLOW_COOKIES alanına yapıştır.
2b. Docker
docker run --rm -p 8080:8080 \
-v ~/.google-flow-mcp/cookies.json:/secrets/cookies.json:ro \
-e FLOW_COOKIES_FILE=/secrets/cookies.json \
-e FLOW_MCP_AUTH_TOKEN=uzun-rastgele-bir-deger \
ghcr.io/umutkdev/google-flow-mcp:latest
claude mcp add --transport http google-flow http://localhost:8080/mcp \
--header "Authorization: Bearer uzun-rastgele-bir-deger"2c. Yerel stdio
claude mcp add google-flow --env FLOW_COOKIES_FILE="$HOME/.google-flow-mcp/cookies.json" \
-- google-flow-mcp serve --transport stdioYerelde Chrome penceresi görünür. Görmek istemiyorsan Linux'ta xvfb-run ile başlat.
Araçlar
Araç | Ne yapar | Kredi |
| Oturum, hesap, varsayılan proje, bütçe ve işler | – |
| Modeller, oranlar, süreler ve tahmini maliyetler | – |
| Proje aç ya da varsayılanı seç | – |
| Projedeki medyayı listele, süresi dolan URL'leri yenile | – |
| Resmi projeye yükle, medya kimliği al | – |
| Nano Banana ile resim üret, düzenle, referansla tutarlı tut | Ücretsiz |
| 2K/4K büyütme | Ücretsiz |
| Videonun tahmini maliyeti ve kalan bütçe | – |
| Omni/Veo video, | Harcar |
| Çok çekimli tutarlı kareler, isteğe bağlı canlandırma | Canlandırırsa harcar |
| Arka plan işlerini yönet | – |
| Hata ayıklama | – |
En az kredi harcayan akış: önce ücretsiz resimle kareyi oturt, sonra yalnız onaylanan kareyi mode="frame" ile canlandır.
Yapılandırma
Değişken | Varsayılan | Açıklama |
| – | Bağlanan çerez dosyasının yolu (Docker birimi, Kubernetes Secret) |
| – | Aynı içerik metin olarak: base64 (önerilen), JSON ya da cookies.txt. Obot için bunu kullan |
| – | Kalıcı Chrome profili (Docker birimi). Verilirse çerezlere gerek kalmaz |
| – | Varsayılan Flow projesi |
|
| Videoya harcanabilecek en fazla kredi. |
|
| Bu tahminin üstündeki isteklerde |
|
| Varsayılan resim modeli |
|
| İki ücretli istek arasındaki en kısa süre (saniye) |
|
| Bir aracın iş kimliği dönmeden önce bekleyeceği süre |
|
| Bir videonun hazır olması için en uzun bekleme |
| – | Beklenen Google e-postası |
| – | Chrome için vekil sunucu (ör. |
| – |
|
|
| Büyütülmüş dosyalar, bütçe defteri, durum |
|
|
|
|
| HTTP portu ve yolu |
| – | Verilirse her istekte |
|
|
|
Doğrulama durumu
34 otomatik test geçiyor. Bunlardan biri gerçek Chrome'u sahte bir
flow.google.comile sürüyor ve reCAPTCHA atlatmasını, yüklemeyi, resim üretimini, metinden ve kareden videoyu, yoklamayı, büyütmeyi, bütçe tavanını ve MCP araçlarını uçtan uca sınıyor.Sunucu Xvfb ve gerçek Chrome ile Streamable HTTP üzerinden çalıştırıldı, Bearer token denetimi ve
/healthzdenendi.Canlı Flow'a karşı henüz denenmedi. İstek şekilleri, Ekim–Kasım 2026'da canlı doğrulanmış iki projeden alındı ama Google bunları her an değiştirebilir. İlk kullanımda ücretsiz araçlarla başla:
flow_status,flow_generate_image, sonra 4 saniyelik 360p bir Omni videosu.Kredi maliyetleri topluluk ölçümlerine dayalı, yukarı yuvarlanmış tahminlerdir. Kesin rakam Flow'un kendi gösterdiğidir.
Geliştirme
pip install -e ".[dev]"
python -m playwright install chromium
pytest -q
ruff check src tests
python scripts/smoke_http.py http://localhost:8080/mcp --token ...Lisans
MIT. Türetilen kodun lisansları LICENSES/ altında.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Make AI images and videos with Nano Banana, GPT Image, Veo, Kling and more, using your credits.
Your AI assistant's creative studio. Make images, video, music and speech with Kling 4.0, Seedance 2.5, Nano Banana Pro, GPT Image 2.5 and more, billed at real model cost. A second brain learns from every generation and 100+ tested workflows, so results get better the more you make
Images, video & speech: Nano Banana, GPT Image, Veo, Omni, Wan, Grok, Gemini TTS. Crypto or card.
Generate AI images, video, voiceovers and music from Claude, ChatGPT or Cursor through 50+ models (Veo 3.1, Kling 3, Seedance, Nano Banana, GPT Image, ElevenLabs). Also image editing, upscaling, background removal, face swap, transcription, voice cloning and UGC-style video ads. Sign in with OAuth — no API key to paste. Tools are annotated (read-only vs. credit-spending); failed generations are refunded.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered image generation and editing with Nano Banana, plus professional video creation with Veo3, all through Kie.ai's APIs. Includes task tracking, status monitoring, and 1080p video upgrades.64 npm23MIT
- AlicenseAqualityDmaintenanceEnables high-quality AI video generation using Google's Veo 3.1 model for text-to-video, style-guided, and frame-interpolation tasks. It features token-efficient reference image handling, batch processing, and video extension capabilities with built-in cost estimation.62MIT
- AlicenseNot gradedqualityBmaintenanceGenerates images, videos, and speech via Google Nano Banana, Veo, Omni, and Gemini TTS models with pay-as-you-go crypto payments, no subscription required.2Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables an AI agent to drive Google Flow through a real logged-in browser session: read projects, media, characters, scenes and credits, create and delete them, upload media, generate Veo video and Nano Banana images, and assemble scenes into a film. Every paid action is priced in its tool description and written to a spend ledger before the click, with a job-id guard against double charges.3MIT