Skip to main content
Glama

flow-mcp — Google Flow MCP Server

Google Flow 전용 MCP 서버(media-gen-mcp에서 분리):0 크레딧 AI 이미지 생성 + 유료 영상 생성(Veo / abra),전부 내 PC의 Chrome 세션(CDP 페이지 컨텍스트)을 통해 구동 —— API key 없음,할당량 없음,제3자 중계 없음.

  • 이미지 생성 / 이미지 확대 / 업로드 / 상태 조회 / 다운로드 / 삭제 / 공유 / 취소 / 캐릭터 엔티티:전부 0 크레딧

  • 영상 생성:Google Flow 크레딧 소모(abra 7-20 / veo lite 10 / fast 20 / quality 100 건당;1080p 업스케일 0)—— 도구 설명에 명시적으로 경고,기본적으로 사용자가 직접 지정할 때만 사용

설치

사전 준비(1회):

  1. PC에 lasso 설치(CC 전체 상호작용 핸들러의 Chrome 실행기)

  2. CDP가 활성화된 Chrome을 실행하고 labs.google에 로그인:

lasso launch-chrome --port 9223 --mode visible   # 首次:窗口出现,完成 Google 登录(2FA 同)
# 之后每天只需:hidden 模式静默驻留
lasso launch-chrome --port 9223
  1. 해당 Chrome에서 https://labs.google/fx/tools/flow 아무 프로젝트 페이지나 열기(실행 상태 유지)

Claude Code 연동:

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

media-gen-mcp와 동시 연동 가능,충돌 없음(아래 「media-gen-mcp와 공존」 참조).

Related MCP server: Grok Image Generation MCP Server

도구(4개)

도구

크레딧

용도

flow_generate_image

0

텍스트-이미지 / 이미지-이미지(베이스+참조 이미지)/ 2K 확대. NARWHAL(Nano Banana 2,기본)/ HARBOR_SEAL / GEM_PIX_2(Nano Banana Pro). aspect(16:9/9:16/1:1/3:4/4:3) 및 seed 정밀 재현 지원

flow_generate_video

🔴 유료

영상 제출(t2v/i2v/r2v/첫·끝 프레임/연장/편집/업스케일). 제출만 하고 대기하지 않음,즉시 mediaId 핸들 반환

flow_status

0

원스톱 자체 점검:크레딧 잔액 / 실시간 모델 카탈로그(각 key의 크레딧 가격과 소요 시간)/ 미디어 목록 / 단일 미디어 상태 및 다운로드 / 일괄 삭제 / 공개 공유 링크 / 생성 중 작업 취소. 영상 핸들의 폴링 경로이기도 함

flow_entity

0

캐릭터 엔티티:캐릭터 카드 생성 / 30개 중 1개 프리셋 음성 바인딩 / 캐릭터 이미지 바인딩

일반적인 흐름:

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

설정(media-gen-mcp와 파일 공유)

설정 파일:~/.media-gen-mcp/config.json(두 패키지가 동일 파일을 읽음 —— 「같은 기능의 서로 다른 구현 채널」을 한 파일에서 통합 on/off).디렉터리 이름은 기존 이름을 유지,변경 금지(Flow 프로젝트 ID가 ~/.media-gen-mcp/flow-project.json에 영구 기록되며,이름을 바꾸면 고아화됨).

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

필드

기본값

역할

flow.enabled

true

false = S000 게이트:4개 도구는 여전히 등록되지만,호출 즉시 [flow] S000 구조화 오류(수정 안내 포함) 반환.설정 변경 후 세션 재시작 필요

flow.imageRouting

"prefer"

prefer = 이미지 생성 도구 설명에 「0 크레딧 우선」 안내 주입(소프트 라우팅);on-demand = 사용자가 Flow를 직접 지정할 때만 사용

flow.videoRouting

"explicit-only"

explicit-only(크레딧 레드라인)= 영상 도구는 사용자가 Flow/Veo/abra를 명시적으로 요청할 때만 사용;prefer = 우선 채널로 사용(여전히 유료 경고)

flow.toolDeadlineMs

110000

단일 도구 호출 하드 상한(멈춤 방지;초과 시 [flow] S410 반환,생성은 서버에서 계속되며 flow_status로 찾을 수 있음)

providers.flow.cdpPort

9223

CDP 포트(lasso launch-chrome --port와 일치)

providers.flow.projectId

(기본값 없음)

기본값이면 flow-project.json의 영구 프로젝트를 읽음(권장 —— 프로젝트 ID 영구 재사용)

providers.flow.models.video.default

(없음)

의도적으로 내장 기본값 없음:영상은 유료이므로 반드시 model을 명시적으로 전달하거나 여기에 명시적으로 설정

전체 예시는 config.example.json 참조.

media-gen-mcp와 공존

  • 두 패키지가 ~/.media-gen-mcp/config.json공유;media-gen 자체의 imageProviderPriority / videoProviderPriority 체인은 해당 패키지 내에서만 적용

  • 분리 후 패키지 간 우선순위 = 본 패키지 도구 설명 소프트 라우팅(imageRouting/videoRouting이 Claude가 flow_generate_image를 우선 선택하도록 안내)+ enabled 총괄 스위치 —— 패키지 간 하드 리다이렉트는 없음(물리적으로 두 패키지는 서로 보이지 않음,정직한 설계)

  • flow-project.json / flow-entities.json은 본 패키지 소관;media-gen 쪽은 Flow 제거 후 더 이상 읽기/쓰기 안 함

오류 코드 빠른 참조([flow] S<code>)

코드

의미

처리

S000

설정이 비활성화됨

오류 안내대로 flow.enabledtrue로 되돌리고 세션 재시작

S100

CDP 연결 불가

lasso launch-chrome --port 9223

S101

labs.google 페이지 없음

해당 Chrome에서 Flow 프로젝트 페이지 열기

S102

로그인 안 됨

해당 Chrome에서 labs.google 로그인 완료

S104

reCAPTCHA 실패

Flow 페이지에 머문 채 재시도

S1xx 기타

환경 사전 조건

환경 준비 후 재시도;이미지 생성은 다른 이미지 도구로 대체 가능

S2xx

페이지 fetch 실패

message 내 상위 응답 조각 확인

S300/S301/S303

모델/파라미터/모드 검증

message 안내대로 key 또는 파라미터 변경(제출 전 차단,크레딧 소모 없음)

S400

mediaId가 이 프로젝트에 없음

파라미터 없이 flow_status 호출로 전체 media 확인

S402

다운로드 불완전

바로 재시도

S410

도구 계층 타임아웃(멈춤 방지)

생성은 여전히 서버에서 진행 중;flow_status 파라미터 없이 호출해 찾기

환경 요구사항

  • Node.js ≥ 18

  • PC의 Chrome(lasso로 --remote-debugging-port=9223로 실행)및 labs.google 로그인

  • FFmpeg는 패키지에 포함(ffmpeg-static;산출물 적법성 자체 점검용,없으면 자동으로 안내로 대체)

License

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