Skip to main content
Glama

gwanggo-mcp

AI 에이전트에 이미지 및 영상 생성 기능을 부여하세요.

MCP 서버 + 광고(Gwanggo) API용 CLI — Seedream, Sora, Veo, Kling, GPT Image 등 30개 이상의 모델을 하나의 키로 제공합니다.

npm License: MIT MCP

Claude Code · Claude Desktop · Cursor · Codex 등 MCP를 지원하는 모든 도구에서 사용할 수 있습니다.


You: "우리 신제품 세럼 광고 이미지 만들어줘, 화장품 무드로"
Agent: [calls generate_image with seedream-5] → https://…/result.png

설정 (2분)

1. 계정 연결 (브라우저 승인 창이 열립니다 — 비밀번호를 붙여넣을 필요 없음):

npx gwanggo-mcp login
# or, after install:
gwanggo auth login

새 계정에는 무료 크레딧이 제공됩니다: gwanggo.ai에서 가입하세요. login을 건너뛰고 GWANGGO_API_KEY를 설정할 수도 있습니다(Dashboard → API keys에서 생성).

2. 에이전트에 추가:

Claude Code

claude mcp add gwanggo -- npx -y gwanggo-mcp

Claude Desktop / Cursor (claude_desktop_config.json / .cursor/mcp.json)

{
  "mcpServers": {
    "gwanggo": {
      "command": "npx",
      "args": ["-y", "gwanggo-mcp"]
    }
  }
}

Codex CLI (~/.codex/config.toml)

[mcp_servers.gwanggo]
command = "npx"
args = ["-y", "gwanggo-mcp"]

login 대신 키를 명시적으로 전달하려면 "env": { "GWANGGO_API_KEY": "gwk_..." }을 추가하세요.

Related MCP server: Corent MCP Server

도구

도구

기능

list_models

크레딧 비용과 모델별 옵션을 포함한 35개 이상의 이미지/영상 모델 목록

generate_image

텍스트→이미지 / 이미지 편집. 완료를 기다렸다가 URL을 반환합니다

generate_video

텍스트→영상 / 이미지→영상 (Seedance 2.0, Kling 3.0, Veo 3.1, Sora 2 …)

get_task

이전 생성 작업을 ID로 확인

get_credits

남은 크레딧 잔액

실패한 생성은 서버 측에서 자동 환불됩니다.

CLI 사용법

동일한 바이너리가 CLI로도 사용됩니다:

gwanggo auth login
gwanggo models
gwanggo generate image "neon alley cat, cinematic" --model gpt-image-2 --quality high
gwanggo generate video "waves crashing at dawn" --model seedance-2.0 --resolution 720p --duration 5 --generate-audio
gwanggo me          # account and credits
gwanggo task <id>   # check status

gwanggo 명령어는 gwanggo auth login으로 저장된 계정을 재사용하므로 API 키 환경 변수가 필요하지 않습니다. GWANGGO_API_KEY는 CI 및 기타 비대화형 환경에서 계속 사용할 수 있습니다.

작동 방식

공개 Gwanggo /v1 REST API 위의 얇은 클라이언트입니다 — 오픈소스 Gwanggo Studio를 구동하는 동일한 API입니다. 키는 ~/.config/gwanggo/config.json(0600)에 저장되며 Bearer 토큰으로만 전송됩니다. 브라우저 로그인 키는 GWANGGO_API_KEY보다 우선하므로, 오래된 환경 키가 새로 승인된 로그인을 덮어쓸 수 없습니다. 로그인 파일이 없는 CI에서는 GWANGGO_API_KEY가 사용됩니다.

라이선스

MIT

Available Tools

5 tools
generate_imageA

Generate an image with a Gwanggo model. Spends credits. Waits for completion and returns the image URL. Use list_models first to choose a model slug and see its options.

Inputs: model (required), prompt (required), quality, image_url, +1 more.

generate_videoA

Generate a video with a Gwanggo model. Spends credits (often per-second — check list_models). Waits up to 10 minutes and returns the video URL.

Inputs: model (required), prompt (required), duration, image_url, +3 more.

get_creditsA

Get the connected Gwanggo account email and remaining credit balance.

Inputs: no named parameters.

get_taskA

Check the status/result of a previous generation by its id.

Inputs: id (required).

list_modelsA

List available AI image/video generation models with credit costs and per-model options (aspect ratios, resolutions, durations). Call this first to pick a model slug.

Inputs: type.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool serves a distinct function: generating images, generating videos, checking credits, checking task status, and listing models. No overlaps or ambiguity.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (generate_image, generate_video, get_credits, get_task, list_models), making predictions easy.

    Tool Count5/5

    With 5 tools, the set covers the core workflow for an AI media generation service without being too sparse or excessive.

    Completeness4/5

    The surface covers model discovery, generation for both image and video, credit tracking, and task status. Missing a cancel/delete tool is a minor gap but not critical.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI image and video generation using Google Nano Banana and Veo 3.1 via a LiteLLM gateway, providing tools for synchronous image generation and asynchronous video generation with polling, returning public URLs.
      4
      MIT
    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Gives AI assistants the ability to generate and iteratively refine images and videos with Google AI Studio models, including image creation/editing, Veo and Omni video generation, and async job tracking. Also lets them analyze existing media and list the models available with their API key.
      1
      ISC