Overview

Gawain MCP Skills is an MCP server that brings Gawain AI video generation directly into Claude Code. Just provide a product name and image URL, and AI automatically generates a promotional video.

Auto language detection — Supports Japanese, English, Chinese, and Korean. Language is automatically detected from product text.

Quick Start

claude mcp add gawain -- npx @gawain-ai/mcp-server

With an API key (optional):

claude mcp add gawain -e GAWAIN_API_KEY=gawain_live_xxx -- npx @gawain-ai/mcp-server

Free Tier is available without an API key.

Usage

Just talk to Claude Code:

User:   Create a video for this product
        Title: Yubari King Melon Premium
        Image: https://example.com/melon.png
        Price: $89.80

Claude: Auto-detected language: English (en)
        Video generation started (Job: ee036ba8-...)
        Estimated completion: ~10 minutes.

        ... (automatic status checks) ...

        Video is ready!
        https://cdn.gawain.nogeass.com/public/.../final.mp4

Cross-language Videos

Generate videos in a different language from the product text:

User:   Create a Chinese version of this product video
Claude: Generating with language="zh". LLM will translate the script to Chinese.

Examples (Copy & Paste)

English — Home Appliance

Title: ZenBreeze Pro Air Purifier
Image: https://cdn.gawain.nogeass.com/shoes/1_gawain_generated.png
Price: 299
Description: Ultra-quiet HEPA air purifier with smart sensor. Covers up to 500 sq ft. Perfect for allergies and pet owners.
Language: en

Japanese — Premium Food

Title: 夕張メロン 特秀品
Image: https://cdn.gawain.nogeass.com/melon/1_gawain_generated.png
Price: 8980
Description: 北海道夕張産の最高級メロン。糖度15度以上、とろける果肉。贈答用にも最適。
Language: ja

Chinese — Cross-border (Japanese product → Chinese video)

Title: 京都宇治抹茶 最高級品
Image: https://cdn.gawain.nogeass.com/wine/1_gawain_generated.png
Price: 3200
Description: 京都府宇治産の石臼挽き抹茶。茶道にも使える最高級品。豊かな旨味と鮮やかな緑色。
Language: zh

Korean — K-Beauty

Title: 유바리 멜론 콜라겐 마스크팩
Image: https://cdn.gawain.nogeass.com/bag/1_gawain_generated.png
Price: 25000
Description: 유바리 멜론 추출물과 콜라겐이 풍부한 프리미엄 마스크팩. 피부에 수분과 탄력을 선사합니다.
Language: ko

MCP Tools

| Tool | Description | |------|-------------| | generate_video | Submit a video generation job from product info | | check_job_status | Check job progress and get the completed video URL |

generate_video Parameters

| Parameter | Type | Required | Description | |-----------|------|:--------:|-------------| | title | string | ✅ | Product name (max 80 chars) | | image_url | string | ✅ | Publicly accessible product image URL | | description | string | — | Product description (max 200 chars) | | price | string | — | Price amount (e.g. "8980") | | currency | string | — | Currency code (default: JPY) | | language | string | — | auto / ja / en / zh / ko (default: auto) |

check_job_status Parameters

| Parameter | Type | Required | Description | |-----------|------|:--------:|-------------| | job_id | string | ✅ | The jobId returned by generate_video |

Claude Code Skills

| Skill | Description | |-------|-------------| | /generate-video | Interactively generate a video (gather info → generate → notify) | | /monitor-jobs | Monitor job progress (works with /loop) |

.mcp.json Configuration

Add .mcp.json to your project root:

{
  "mcpServers": {
    "gawain": {
      "type": "stdio",
      "command": "npx",
      "args": ["@gawain-ai/mcp-server"],
      "env": {
        "GAWAIN_API_KEY": ""
      }
    }
  }
}

Architecture

User → Claude Code → MCP Server (this package)
                         ↓
                    Gawain API → SQS → GPU Server → Video
                         ↓
                    Claude Code ← CDN URL

Language Detection

| Text | Detected | |------|----------| | 夕張メロン 特秀品 | ja (Hiragana/Katakana) | | Yubari King Melon | en (Latin) | | 夕张甜瓜 特秀品 | zh (CJK only) | | 유바리 멜론 프리미엄 | ko (Hangul) |

Environment Variables

| Variable | Required | Description | |----------|:--------:|-------------| | GAWAIN_API_KEY | No | API key for premium features (gawain_live_...) | | GAWAIN_API_BASE | No | API base URL (default: https://gawain.nogeass.com) |

No .env files — Use claude mcp add -e or .mcp.json env field for configuration. For CI/CD, use GitHub Secrets.

Development

cd mcp-server
npm install
npm run build
npm start

Contributing

Issues and pull requests are welcome at GitHub.

About

Developed and maintained by no geass inc.

License

MIT — Copyright (c) 2026 no geass inc.