Skip to main content
Glama
deenesjakoruzh
wangdong233

flow-mcp

by wangdong233
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

flow-mcp — Servidor MCP de Google Flow

Servidor MCP independiente para Google Flow (separado de media-gen-mcp):generación de imágenes con IA por 0 créditos + generación de video con facturación (Veo / abra), todo impulsado a través de la sesión de Chrome de tu máquina local (contexto de página CDP) — sin API key, sin cuotas, sin reenvío por terceros.

  • Generación de imágenes / ampliación de imágenes / carga / consulta de estado / descarga / eliminación / compartir / cancelar / entidades de personajes:todo por 0 créditos

  • Generación de video:consume créditos de Google Flow (abra 7-20 / veo lite 10 / fast 20 / quality 100 por cada uno; superresolución 1080p 0) — se advierte explícitamente en la descripción de la herramienta, por defecto solo se usa cuando el usuario lo solicita explícitamente

Instalación

Requisitos previos (una sola vez):

  1. Instala lasso en tu máquina (el lanzador de Chrome en el agarre interactivo completo de CC)

  2. Inicia Chrome con CDP e inicia sesión en labs.google:

lasso launch-chrome --port 9223 --mode visible   # 首次:窗口出现,完成 Google 登录(2FA 同)
# 之后每天只需:hidden 模式静默驻留
lasso launch-chrome --port 9223

  1. Abre cualquier página de proyecto de https://labs.google/fx/tools/flow en ese Chrome (mantenlo en ejecución)

Integración con Claude Code:

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

Se puede integrar simultáneamente con media-gen-mcp sin conflictos (consulta «Coexistencia con media-gen-mcp» más abajo).

Related MCP server: Grok Image Generation MCP Server

Herramientas (4)

Herramienta

Créditos

Uso

flow_generate_image

0

Texto a imagen / imagen a imagen (imagen base + imagen de referencia) / ampliación 2K. NARWHAL (Nano Banana 2, predeterminado) / HARBOR_SEAL / GEM_PIX_2 (Nano Banana Pro). Admite aspect (16:9/9:16/1:1/3:4/4:3) y seed para reproducción exacta

flow_generate_video

🔴 Con facturación

Envío de video (t2v/i2v/r2v/fotogramas inicial y final/extensión/edición/superresolución). Solo envía sin esperar, devuelve inmediatamente el identificador mediaId

flow_status

0

Introspección integral: saldo de créditos / catálogo de modelos en tiempo real (precio en créditos y tiempo de cada key) / lista de medios / estado y descarga de un medio individual / eliminación por lotes / enlace de uso compartido público / cancelar tareas en generación. También es la ruta de sondeo para los identificadores de video

flow_entity

0

Entidades de personajes: crear tarjeta de personaje / vincular 1 de 30 voces preestablecidas / vincular imagen de apariencia

Flujo típico:

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

Configuración (comparte un archivo con media-gen-mcp)

Archivo de configuración:~/.media-gen-mcp/config.json (ambos paquetes leen el mismo archivo — «diferentes canales de implementación de la misma función» se activan/desactivan de forma unificada en un solo archivo). El nombre del directorio conserva el nombre histórico,no lo cambies (el ID del proyecto de Flow se registra permanentemente en ~/.media-gen-mcp/flow-project.json; cambiarlo dejaría huérfano el proyecto).

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

Campo

Predeterminado

Función

flow.enabled

true

false = puerta de acceso S000: los 4 herramientas siguen registradas, pero la llamada devuelve inmediatamente un error estructurado [flow] S000 (con guía de reparación incorporada). Tras cambiar la configuración, debe reiniciarse la sesión

flow.imageRouting

"prefer"

prefer = la descripción de la herramienta de generación de imágenes inyecta la guía «prioridad 0 créditos» (enrutamiento suave);on-demand = solo se usa cuando el usuario solicita explícitamente Flow

flow.videoRouting

"explicit-only"

explicit-only (línea roja de créditos) = la herramienta de video solo se usa cuando el usuario solicita explícitamente Flow/Veo/abra;prefer = como opción preferida (aún se advierte sobre la facturación)

flow.toolDeadlineMs

110000

Límite máximo duro de una sola llamada de herramienta (evita bloqueos; al expirar devuelve [flow] S410, la generación continúa en el servidor y se puede recuperar mediante flow_status)

providers.flow.cdpPort

9223

Puerto CDP (coincide con lasso launch-chrome --port)

providers.flow.projectId

(ausente)

Si falta, lee el proyecto permanente de flow-project.json (recomendado — el ID del proyecto se reutiliza permanentemente)

providers.flow.models.video.default

(ninguno)

Deliberadamente sin valor predeterminado integrado: el video se factura, debe pasarse explícitamente model o configurarse explícitamente aquí

Ejemplo completo en config.example.json.

Coexistencia con media-gen-mcp

  • Ambos paquetes comparten ~/.media-gen-mcp/config.json; la cadena imageProviderPriority / videoProviderPriority propia de media-gen solo tiene efecto dentro de su paquete

  • La prioridad entre paquetes tras la separación = enrutamiento suave en la descripción de herramientas de este paquete (guía de imageRouting/videoRouting para que Claude elija flow_generate_image primero) + interruptor general enabled — no existe redirección dura entre paquetes (físicamente los dos paquetes no se ven entre sí, diseño honesto)

  • flow-project.json / flow-entities.json pertenecen a este paquete; el lado de media-gen, tras eliminar Flow, ya no los lee ni escribe

Referencia rápida de códigos de error ([flow] S<code>)

Código

Significado

Manejo

S000

Configuración deshabilitada

Sigue la guía del error para cambiar flow.enabled de vuelta a true, reinicia la sesión

S100

CDP no conectable

lasso launch-chrome --port 9223

S101

Sin página de labs.google

Abre la página del proyecto de Flow en ese Chrome

S102

Sin iniciar sesión

Completa el inicio de sesión en labs.google en ese Chrome

S104

Fallo de reCAPTCHA

Quédate en la página de Flow y reintenta

S1xx resto

Requisito previo de entorno

Reintenta cuando el entorno esté listo; la generación de imágenes puede recurrir a otras herramientas de imagen

S2xx

Fallo de fetch de página

Revisa el fragmento de respuesta ascendente dentro del mensaje

S300/S301/S303

Validación de modelo/parámetros/modo

Cambia la key o los parámetros según la guía del mensaje (interceptado antes del envío, cero consumo)

S400

mediaId no está en este proyecto

Llama a flow_status sin parámetros para ver todos los medios

S402

Descarga incompleta

Reintenta directamente

S410

Límite de tiempo de la capa de herramienta (evita bloqueos)

La generación aún continúa en el servidor; recupera con flow_status sin parámetros

Requisitos del entorno

  • Node.js ≥ 18

  • Chrome local (iniciado mediante lasso con --remote-debugging-port=9223) con sesión iniciada en labs.google

  • FFmpeg incluido con el paquete (ffmpeg-static; solo para la autoverificación de validez del producto, si falta se degrada automáticamente a una notificación)

Licencia

MIT

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

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.

Tools

Related MCP Servers

View all related MCP servers

Related MCP Connectors

  • vap-e

    AI image, video & music generation. Flux, Veo 3.1, Suno V5. Free tier included.

  • avots

    Image, video, audio, face-swap, talking avatars and chat across 300+ AI models, one balance.

  • BananaBanana Image, Video & Speech Generation

    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