UnrealUGC

com.unrealugc由 unrealugc.com 发布官方发布者v1.0.0更新于 Oct 24, 2026

Generate and manage AI UGC video ads through eleven typed MCP tools

已验证Streamable HTTP可网页运行媒体与设计AI 与机器学习

概览

AI 生成的概览

UnrealUGC 官方 MCP 服务器让助手浏览创作者、模型与声音，估算积分成本，并生成 AI UGC 视频广告。

可以做什么
查询 API 密钥对应的账户、套餐与积分池，并浏览可用的视频模型、库存创作者、自定义形象与声音。查找并创建用于归集相关生成任务的项目。按筛选与分页浏览生成历史，并轮询某次生成以获取输出链接。在花费前根据脚本估算积分成本，然后启动异步视频生成，支持原生或指定声音、无声反应或 B-roll 片段、逐场景视觉指令，以及并行或串行的多片段生成。
适用场景
适合让助手端到端地策划并制作 AI UGC 视频广告：选择模型与创作者，对照余额检查脚本的积分成本，启动生成并轮询直到视频就绪。
运行要求
可使用托管远程端点并携带 Authorization bearer 头，或使用通过 npx 运行的本地 npm 包，后者需要 Node.js 20 或更高版本。需要来自 Dashboard 设置的 UnrealUGC API 密钥，通过 UNREALUGC_API_KEY 或 Authorization 头提供。另有可选的 UNREALUGC_BASE_URL 与 UNREALUGC_REQUEST_TIMEOUT_MS 设置；需要能访问 UnrealUGC 的网络。
安装前请注意
API 密钥是有效密钥（以 usk_live_ 开头），应保存在客户端的环境设置中，不要提交到代码仓库。生成视频会消耗积分，请先查看估算与余额；生成是异步的，需要轮询或通过 webhook 跟踪。创建项目和启动生成会向你的 UnrealUGC 账户写入数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 UnrealUGC，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/com.unrealugc%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "unrealugc": {
      "type": "http",
      "url": "https://unrealugc.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

UnrealUGC MCP Server

[npm] [CI]

The official Model Context Protocol server for UnrealUGC. It gives MCP-compatible assistants eleven typed tools for browsing creators and models, estimating credit cost, and generating AI UGC video ads.

This repository contains only the public MCP adapter. The UnrealUGC application and backend remain private.

Prerequisites

  • Node.js 20 or newer
  • An UnrealUGC API key from Dashboard → Settings → API Keys

API keys start with usk_live_ and should be stored in your MCP client's environment settings, never committed to a repository.

Local stdio setup

You do not need to install the package globally. MCP clients can launch it with npx.

Claude Desktop

Add this server to your Claude Desktop configuration:

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

Claude Code

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

Codex

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

Cursor, Windsurf, OpenClaw, and other stdio MCP clients use the same command and environment variable.

Hosted Streamable HTTP setup

Clients that support remote MCP can connect without running a local process:

text
URL: https://unrealugc.com/api/mcpAuthorization: Bearer usk_live_...

See the MCP setup guide for client-specific instructions.

Tools

ToolPurpose
get_meConfirm the account, plan, and balance behind an API key
get_creditsRead subscription and purchased credit pools
list_modelsBrowse available video models and capabilities
list_creatorsBrowse stock creators and custom avatars
list_voicesBrowse stock and custom voices
list_projectsFind product and campaign projects
create_projectCreate a project for related generations
list_videosBrowse generation history with filters and pagination
get_videoPoll a generation and retrieve its output URL
estimate_video_costEstimate credits from the script before spending
generate_videoStart an asynchronous video generation

generate_video supports native or selected voices, silent reaction/b-roll clips, per-scene visual directions, and parallel or sequential multi-clip generation.

Generation flow

  1. Call list_models and list_creators.
  2. Call estimate_video_cost with the proposed script.
  3. Check get_credits if budget matters.
  4. Call generate_video.
  5. Poll get_video about every 15 seconds, or use UnrealUGC webhooks for completion events.

Environment variables

VariableRequiredDefault
UNREALUGC_API_KEYYes—
UNREALUGC_BASE_URLNohttps://unrealugc.com
UNREALUGC_REQUEST_TIMEOUT_MSNo30000

UNREALUGC_BASE_URL is intended for UnrealUGC development and staging environments.

Development

bash
npm cinpm run checknpm pack --dry-run

See CONTRIBUTING.md before opening a pull request. Security reports should follow SECURITY.md.

Links

License

MIT © Next MVP Solutions LLC

来源：README.md，提交 92ad634

工具

0
SourceWeft 尚未读取此服务器的工具。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 85%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分