UnrealUGC

UnrealUGC MCP サーバー

UnrealUGC の公式 Model Context Protocol サーバーです。 MCP 互換のアシスタントに、クリエイターやモデルの閲覧、クレジット費用の見積もり、AI UGC 動画広告の生成に使える、型付きの 11 個のツールを提供します。

このリポジトリには、公開 MCP アダプターのみが含まれています。UnrealUGC のアプリケーションとバックエンドは非公開のままです。

前提条件

• Node.js 20 以降
• Dashboard → Settings → API Keys から取得した UnrealUGC API キー

API キーは usk_live_ で始まります。MCP クライアントの環境設定に保存し、リポジトリには絶対にコミットしないでください。

ローカルの stdio セットアップ

パッケージをグローバルにインストールする必要はありません。MCP クライアントから npx で起動できます。

Claude Desktop

Claude Desktop の設定にこのサーバーを追加します。

{
  "mcpServers": {
    "unrealugc": {
      "command": "npx",
      "args": ["-y", "@unrealugc/mcp"],
      "env": {
        "UNREALUGC_API_KEY": "usk_live_..."
      }
    }
  }
}

Claude Code

claude mcp add unrealugc --env UNREALUGC_API_KEY=usk_live_... -- npx -y @unrealugc/mcp

Codex

[mcp_servers.unrealugc]
command = "npx"
args = ["-y", "@unrealugc/mcp"]

[mcp_servers.unrealugc.env]
UNREALUGC_API_KEY = "usk_live_..."

Cursor、Windsurf、OpenClaw など、ほかの stdio MCP クライアントでも同じコマンドと環境変数を使用します。

ホスト型 Streamable HTTP セットアップ

リモート MCP に対応したクライアントは、ローカルプロセスを実行せずに接続できます。

URL: https://unrealugc.com/api/mcp
Authorization: Bearer usk_live_...

クライアントごとの手順については、MCP セットアップガイドをご覧ください。

ツール

ツール	目的
get_me	API キーに紐付いたアカウント、プラン、残高を確認します
get_credits	サブスクリプションと購入済みのクレジットプールを確認します
list_models	利用可能な動画モデルと機能を閲覧します
list_creators	ストッククリエイターとカスタムアバターを閲覧します
list_voices	ストック音声とカスタム音声を閲覧します
list_projects	商品やキャンペーンのプロジェクトを探します
create_project	関連する生成をまとめるプロジェクトを作成します
list_videos	フィルターとページネーションを使って生成履歴を閲覧します
get_video	生成状況を確認し、出力 URL を取得します
estimate_video_cost	クレジットを消費する前に、スクリプトに基づいて費用を見積もります
generate_video	非同期の動画生成を開始します

generate_video は、ネイティブ音声または選択した音声、無音のリアクション／B ロールクリップ、シーンごとのビジュアル指示、複数クリップの並列または順次生成に対応しています。

生成の流れ

1. list_models と list_creators を呼び出します。
2. 提案するスクリプトを使って estimate_video_cost を呼び出します。
3. 予算が重要な場合は get_credits を確認します。
4. generate_video を呼び出します。
5. 約 15 秒ごとに get_video を呼び出して状況を確認するか、完了イベントの受信に UnrealUGC の Webhook を使用します。

環境変数

変数	必須	デフォルト
UNREALUGC_API_KEY	はい	—
UNREALUGC_BASE_URL	いいえ	https://unrealugc.com
UNREALUGC_REQUEST_TIMEOUT_MS	いいえ	30000

UNREALUGC_BASE_URL は、UnrealUGC の開発環境およびステージング環境での使用を想定しています。

開発

npm ci
npm run check
npm pack --dry-run

プルリクエストを作成する前に、CONTRIBUTING.mdをご確認ください。セキュリティに関する報告はSECURITY.mdに従ってください。

リンク

• UnrealUGC MCP の概要
• MCP ドキュメント
• REST API ドキュメント
• UnrealUGC ダッシュボード

ライセンス

MIT © Next MVP Solutions LLC