gwanggo-mcp
gwanggo-mcp
Geben Sie Ihrem KI-Agenten die Möglichkeit, Bilder & Videos zu generieren.
MCP-Server + CLI für die Gwanggo API — Seedream, Sora, Veo, Kling, GPT Image und 30+ weitere Modelle hinter einem einzigen Schlüssel.
Funktioniert mit Claude Code · Claude Desktop · Cursor · Codex — mit allem, was MCP spricht.
You: "우리 신제품 세럼 광고 이미지 만들어줘, 화장품 무드로"
Agent: [calls generate_image with seedream-5] → https://…/result.pngEinrichtung (2 Minuten)
1. Verbinden Sie Ihr Konto (öffnet eine Browser-Autorisierung — kein Passwort-Einfügen):
npx gwanggo-mcp login
# or, after install:
gwanggo auth loginNeue Konten erhalten kostenlose Credits: Melden Sie sich unter gwanggo.ai an. Sie können
loginauch überspringen undGWANGGO_API_KEYsetzen (einen solchen Schlüssel erstellen Sie unter Dashboard → API keys).
2. Fügen Sie es zu Ihrem Agenten hinzu:
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"]Um den Schlüssel explizit statt login zu übergeben, fügen Sie "env": { "GWANGGO_API_KEY": "gwk_..." } hinzu.
Related MCP server: Corent MCP Server
Werkzeuge
Werkzeug | Beschreibung |
| 35+ Bild-/Videomodelle mit Credit-Kosten und Optionen pro Modell |
| Text→Bild / Bildbearbeitung. Wartet auf Abschluss und gibt die URL zurück. |
| Text→Video / Bild→Video (Seedance 2.0, Kling 3.0, Veo 3.1, Sora 2 …) |
| Prüft eine frühere Generierung anhand der ID |
| Verbleibendes Credit-Guthaben |
Fehlgeschlagene Generierungen werden serverseitig automatisch erstattet.
CLI-Nutzung
Dieselbe Binärdatei dient auch als 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 statusDie gwanggo-Befehle verwenden das von gwanggo auth login gespeicherte Konto; es ist keine API-Key-Umgebungsvariable erforderlich. GWANGGO_API_KEY bleibt für CI und andere nicht-interaktive Umgebungen verfügbar.
So funktioniert es
Ein schlanker Client für die öffentliche Gwanggo /v1 REST API — dieselbe API, die auch das Open-Source-Projekt Gwanggo Studio antreibt. Ihr Schlüssel wird unter ~/.config/gwanggo/config.json (0600) gespeichert und nur als Bearer-Token gesendet. Ein Browser-Login-Schlüssel hat Vorrang vor GWANGGO_API_KEY, sodass ein veralteter Umgebungsschlüssel einen neu genehmigten Login nicht überschreiben kann. In CI-Umgebungen, in denen keine Login-Datei existiert, wird GWANGGO_API_KEY verwendet.
Lizenz
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