gwanggo-mcp
gwanggo-mcp
AI 에이전트에 이미지 및 영상 생성 기능을 부여하세요.
MCP 서버 + 광고(Gwanggo) API용 CLI — Seedream, Sora, Veo, Kling, GPT Image 등 30개 이상의 모델을 하나의 키로 제공합니다.
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-mcpClaude 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
도구
도구 | 기능 |
| 크레딧 비용과 모델별 옵션을 포함한 35개 이상의 이미지/영상 모델 목록 |
| 텍스트→이미지 / 이미지 편집. 완료를 기다렸다가 URL을 반환합니다 |
| 텍스트→영상 / 이미지→영상 (Seedance 2.0, Kling 3.0, Veo 3.1, Sora 2 …) |
| 이전 생성 작업을 ID로 확인 |
| 남은 크레딧 잔액 |
실패한 생성은 서버 측에서 자동 환불됩니다.
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 statusgwanggo 명령어는 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가 사용됩니다.
라이선스
Available Tools
5 toolsgenerate_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
Scored across 5 tools
Each tool serves a distinct function: generating images, generating videos, checking credits, checking task status, and listing models. No overlaps or ambiguity.
All tool names follow a consistent verb_noun pattern (generate_image, generate_video, get_credits, get_task, list_models), making predictions easy.
With 5 tools, the set covers the core workflow for an AI media generation service without being too sparse or excessive.
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
Generate images and videos with 200+ AI models (GPT-Image-2, Seedance, Veo, Kling) via one API.
Generate images, video, music, voice and 3D through one API. 30 tools, 200+ models.
Generate images and videos (GPT Image, Seedance, Kling, Wan, Qwen) with one API key.
Best Image and video generation: 20+ models (Kling, Seedance, Veo, NB, FLUX.2), OAuth, pay-per-use.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables 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.4MIT
- AlicenseAqualityDmaintenanceEnables AI agents to generate images and videos via the Corent API with automatic model routing, provider fallback, and tools for planning, creation, and balance management.7118 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceGives 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.1ISC

inReels MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate video ads, UGC ads, static image ads, voiceovers, and faceless videos, with tools for quoting, model discovery, asset upload, and run status checks.MIT