GhostViral

GhostViral MCP

一个远程 Model Context Protocol 服务，可让 AI Agent 在 GhostViral AI 账户中制作完成的无露脸视频：脚本、授权库存素材、配音、字幕、音效和 MP4。

• 端点： https://ghostviralai.com/mcp（Streamable HTTP）
• 身份验证： OAuth 2.1，采用 PKCE 和动态客户端注册。你在浏览器中登录 GhostViral；无需复制 API 密钥。
• 注册名称： 官方 MCP Registry 中的 com.ghostviralai/ghostviral
• 文档： https://ghostviralai.com/docs/mcp
• 兼容： Claude（网页端、桌面端、Claude Code）、ChatGPT、Cursor、VS Code，以及其他支持通过 OAuth 连接远程服务的 MCP 客户端。

此仓库包含该服务的公开说明（此 README 和 server.json）。服务本身运行于 ghostviralai.com；无需安装或自托管。

可制作的视频

• 15、30、45 或 60 秒的竖屏 9:16 Shorts、Reels 和 TikTok 视频（1080×1920）
• 5、8 或 12 分钟的横屏 16:9 YouTube 视频（1920×1080）
• 画面采用授权库存视频和照片（Pexels、Pixabay 和开放许可档案），绝不使用 AI 生成的人脸或片段
• 脚本、配音和字幕支持 32 种语言

连接

Claude：“设置” →“连接器” →“添加自定义连接器” → 输入 URL https://ghostviralai.com/mcp，然后登录。

Claude Code：

claude mcp add --transport http ghostviral https://ghostviralai.com/mcp

Cursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "ghostviral": { "url": "https://ghostviralai.com/mcp" }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "ghostviral": { "type": "http", "url": "https://ghostviralai.com/mcp" }
  }
}

首次调用工具时会打开 GhostViral 登录页面。新账户可获得 60 个免费额度，无需信用卡。

Agent 如何使用

Agent 负责做出每项创意决策；工具负责执行。

1. set_script：Agent 提供的脚本（或按要求撰写的脚本），事实类主题需附上来源
2. search_stock：为每个场景查找授权片段和照片，并提供缩略图预览以供查看
3. set_timeline：选择素材，每句话对应一个场景，并检查节奏
4. estimate_credits，然后调用 synthesize_voice（此处收取额度，每个视频收取一次）
5. set_captions，可选调用 set_motion、search_sounds、set_audio、review_audio
6. start_render，然后调用 poll_render 和 get_download_url

start_render 会返回一条命令，由 Agent 在自己的设备上使用 FFmpeg 编码 MP4。如果 Agent 无法运行命令，renderMode: "server" 则会改为在 GhostViral 服务端渲染最长 60 秒的 Shorts。Agent 完成渲染后，poll_render 会报告文件检查结果：时长、大小、响度，以及黑屏或画面冻结片段。

工具

工具	功能
create_project、get_project、list_projects	创建并读取视频项目
get_options、list_voices	视频格式、字幕样式、配音
set_script、plan_visuals	脚本；可选的库存素材搜索建议
search_stock、set_timeline	查找授权素材，设置场景切换点
estimate_credits、synthesize_voice	消费额度前估算费用；生成配音
set_captions、set_composition、set_motion、get_motion_guide	字幕、布局、动态效果和图形
search_sounds、design_sound、set_audio、set_music、review_audio	背景音乐、音效、混音检查
start_render、submit_render、poll_render、get_download_url	渲染和下载
create_faceless_video	一次调用即可快速制作一条 Short
create_schedule_plan、list_schedule_plans、update_schedule_plan、next_scheduled_render、list_social_accounts、schedule_post	付费方案中的排期功能

提示词（prompts/list）：produce_faceless_short、pick_stock_timeline、choose_soundtrack。

每个工具都包含标题，以及只读或破坏性操作提示，因此客户端可以在执行任何会消耗额度的操作前征求确认。

示例请求

• “制作一个 30 秒的竖屏 Short，介绍章鱼有三颗心脏的原因。”
• “研究 Titanic 的历史，并制作一段 8 分钟、16:9 的 YouTube 视频。”
• “将这份脚本制作成一个 60 秒的 TikTok 视频，配上 Pro Bold 字幕和沉稳的男声。”

定价

免费试用：60 个积分，无需银行卡；免费导出的视频带有水印。付费套餐每周 $4.99 起。制作一段带 AI 配音的 30 秒 Short 需 15 个积分。详情：https://ghostviralai.com/pricing

隐私与支持

• 隐私政策：https://ghostviralai.com/privacy
• 条款：https://ghostviralai.com/terms
• 服务出现问题：在此代码库中提交 issue。