Skip to main content
Glama

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.

npm License: MIT MCP

Funktioniert mit Claude Code · Claude Desktop · Cursor · Codex — mit allem, was MCP spricht.


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

Einrichtung (2 Minuten)

1. Verbinden Sie Ihr Konto (öffnet eine Browser-Autorisierung — kein Passwort-Einfügen):

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

Neue Konten erhalten kostenlose Credits: Melden Sie sich unter gwanggo.ai an. Sie können login auch überspringen und GWANGGO_API_KEY setzen (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-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"]

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

list_models

35+ Bild-/Videomodelle mit Credit-Kosten und Optionen pro Modell

generate_image

Text→Bild / Bildbearbeitung. Wartet auf Abschluss und gibt die URL zurück.

generate_video

Text→Video / Bild→Video (Seedance 2.0, Kling 3.0, Veo 3.1, Sora 2 …)

get_task

Prüft eine frühere Generierung anhand der ID

get_credits

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 status

Die 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

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