Repository avatar
Multimedia
v0.1.0
active

viralfacevideo

io.github.sakiila/viralfacevideo

Compare photo-to-video templates by photo count, clip duration, and credit cost.

Documentation

ViralFaceVideo Template Finder

Find a photo-to-video effect for a short dance, celebration, or rap clip. Compare how many photos each template needs, its available lengths, and its credit costs. Preview your chosen template and generate the clip on the ViralFaceVideo website.

MCP

Install viralfacevideo.mcpb in an MCPB-compatible desktop client. For a client with stdio support, clone this repository, run npm ci with Node.js 20 or later, and configure this server:

{
  "mcpServers": {
    "viralfacevideo": {
      "command": "node",
      "args": ["/absolute/path/to/viralfacevideo-agent/src/index.mjs"]
    }
  }
}

Ask, for example, “Find a rap template for two photos and show me the shortest option.” The find_video_templates tool supports photos (1 or 2) and query (English keywords). It fetches the public catalog feed and returns official preview links. No API key is required. Photos stay with you until you choose to upload them on the website.

Agent Skill

From a checkout, list the skill with npx skills add . --list. Once the public repository is available, install it with:

npx skills add sakiila/viralfacevideo-agent --skill viralfacevideo-templates

The skill also works independently by reading the public catalog feed when MCP is unavailable.

验证和发布

  1. 运行 npm ci、npm test、npm run smoke。冒烟测试通过 stdio 调用 MCP,并读取官网实时模板目录。
  2. 用 npm run bundle 生成 .tmp/viralfacevideo.mcpb,需要系统安装 zip。如果重新打包,用 shasum -a 256 .tmp/viralfacevideo.mcpb 更新 server.json 里的 fileSha256,确保登记的哈希对应实际上传的文件。
  3. 将这个目录作为独立的公开仓库 sakiila/viralfacevideo-agent 发布,并把 MCPB 附到与 server.json 一致的 GitHub Release。公开仓库可供 Skills CLI 安装。
  4. Release 可匿名下载后,运行 mcp-publisher login github 和 mcp-publisher publish,登记到官方 MCP Registry。验证登记返回的 websiteUrl 指向官网。MCP Registry 发布文档
MCPB
https://github.com/sakiila/viralfacevideo-agent/releases/download/v0.1.0/viralfacevideo.mcpb
Install Command
# mcpb: https://github.com/sakiila/viralfacevideo-agent/releases/download/v0.1.0/viralfacevideo.mcpb