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