FreeVideoGenerator

FreeVideoGenerator MCP

简体中文 · 客户端设置 · 17 个工具 · 故障排除 · 注册表发布

使用 AI 客户端通过你的 FreeVideoGenerator 账户创建 AI 图像和视频。发现当前可用的模型和 Quick Apps、查询积分费用、上传参考素材、提交单个或批量任务，并获取结果。

此代码仓库包含公开的连接示例、一个无依赖辅助工具、一个可选的 Agent Skill，以及官方 MCP Registry 描述文件。服务运行在 FreeVideoGenerator；网站、身份验证、计费、存储和生成服务提供商仍属于现有服务。辅助工具会输出配置并在本地安装 Skill。

连接

远程 Streamable HTTP 端点：

https://freevideogenerator.app/api/mcp

在客户端的浏览器 OAuth 流程中使用你的 FreeVideoGenerator 账户登录，并检查请求的权限范围。生成任务会使用该账户的积分。发现和查询费用不会提交付费任务。无需提供服务提供商密钥或数据库凭据。

Claude Code

claude mcp add --transport http --scope user freevideogenerator https://freevideogenerator.app/api/mcp

打开 /mcp 并授权连接。

Codex

codex mcp add freevideogenerator --url https://freevideogenerator.app/api/mcp
codex mcp login freevideogenerator

关于 Cursor、Gemini CLI、Kimi Code、ZCode、ChatGPT 和开发者 API 密钥，请参阅客户端设置。直接连接远程 URL；此辅助工具不会实现本地 stdio MCP 服务。

可选 Skill 和辅助工具

需要 Git 和 Node.js 20+。没有 npm 依赖或安装钩子。

git clone https://github.com/horace68/freevideogenerator-mcp.git
cd freevideogenerator-mcp
node bin/freevideogenerator.mjs config codex
node bin/freevideogenerator.mjs install-skill codex
node bin/freevideogenerator.mjs doctor

config 会输出一段配置，供你合并到现有设置中。可用客户端：codex、claude、cursor、gemini、kimi、zcode。它不会更改客户端设置，也不会让你登录。

install-skill codex 会将 skills/freevideogenerator 复制到 ~/.agents/skills/freevideogenerator；install-skill claude 会使用 ~/.claude/skills/freevideogenerator。绝不会覆盖现有目录。当 Agent 发现该 Skill 后，在 Codex 中调用 $freevideogenerator，或在 Claude Code 中调用 /freevideogenerator。如果 Agent 尚未加载该 Skill，请重启 Agent。MCP 连接和授权是彼此独立的。

为项目或其他兼容客户端选择一个上级 skills 目录：

node bin/freevideogenerator.mjs install-skill custom --dir /path/to/project/.agents/skills --dry-run
node bin/freevideogenerator.mjs install-skill custom --dir /path/to/project/.agents/skills

要更新，请将自定义过的 Skill 与此代码仓库中的版本进行比较，将已安装的目录移到其他位置，然后重新安装。要卸载，只需删除已安装的 freevideogenerator 目录。撤销服务访问权限是单独的操作。

doctor 会检查公开资源元数据、授权元数据/PKCE，以及未经身份验证的 MCP 挑战。它不会发送凭据、创建任务或消耗积分。检查通过并不能证明已通过身份验证的生成可用，也不代表与每个客户端都兼容。此辅助工具包为私有包，不会发布到 npm；请使用 Git 代码仓库。

尝试一个任务

发现可用的图像和视频模型，并查询我的积分。使用我选定的图库图像，为一段五秒的产品视频查询费用。如果费用不超过 100 积分，就生成视频、跟踪任务，并提供结果和任务链接。重试时保持请求 ID 不变。

对于本地文件，请使用 create_upload 请求上传，通过 multipart 字段 file 上传，或使用返回的浏览器上传页面；然后读取 get_upload 获取文件 ID。聊天附件或本地路径不会自动提供给服务。工具和工作流介绍费用查询、批量任务、上传和故障恢复。

该服务支持图像/视频生成、已配置的 Quick Apps 和镜头建议。支持的模型、模式和价格会在运行时发现。在支持的情况下，音频文件可用作参考；目前未提供纯音频生成、自动时间轴编辑、组装、支付或发布工具。

访问与验证

OAuth 授权适用于已授予的范围内的整个账户。请在 设置 → 连接 中查看连接，并在 设置 → API 密钥 中查看开发者密钥。撤销授权会阻止后续访问和媒体功能；已接受的任务会继续执行。结果链接会在十分钟后过期，可通过 MCP 续期。安全性与数据范围。

该服务于 2026 年 10 月 19 日记录的发布验收涵盖了 OAuth/PKCE 和刷新、全部 17 个工具、API 密钥、真实图像/视频生成完成、批量重试计费、上传/导入和分段下载。此仓库的公开检查会分别验证服务发现和身份验证质询；此处尚未验证各客户端的 OAuth 和生成流程。请参阅验证状态。

server.json 描述了 io.github.horace68/freevideogenerator 的 1.0.1 版本，该版本于 2026 年 10 月 19 日发布到官方 MCP Registry。公开回读确认了其处于有效/最新状态，且端点元数据一致。Registry 元数据指向托管服务；它不会将辅助工具发布到 npm，也不会安装 Skill。发布与证据。

开发

对于 ChatGPT/Codex 公开目录审核，此仓库还包含插件清单（plugin.json）、OAuth MCP 配置（mcp.json）、现有项目图标和捆绑的 Skill。使用 Python 3.9+ 构建允许上传的 ZIP：

python3 scripts/build-plugin.py

输出文件为 dist/freevideogenerator-plugin-0.1.1.zip，采用门户接受的 Codex 兼容格式。使用 --format portable 可生成 Agent Plugins 格式。两种格式都包含五个正向和三个负向审核案例。 0.1.1 版本于 2026 年 10 月 21 日通过 OpenAI Plugins 提交。门户显示状态为 审核中；发布状态为 未发布。身份/域名验证、OAuth、Skill 检查和 17 工具 MCP 扫描均已通过。软件包包含一个真实演示。已保存所有者提供的审核者访问权限、登录说明、全部八个案例、演示和发布说明。所有者在提交前确认了最后六项政策声明。请参阅提交回执、当前状态和审核证据与限制。 请参阅官方提交指南。

npm run check
npm test
npm pack --dry-run

测试涵盖客户端格式、隔离的 Skill 安装、覆盖/符号链接保护、CLI 故障、公开诊断、Registry 元数据和范围有限的域名验证 Worker。CI 覆盖 Linux、macOS 和 Windows，使用 Node.js 20、22 和 24；需要身份验证或付费的托管操作不纳入 CI。

MIT 许可涵盖此仓库中的辅助工具、示例和 Skill。它不授予服务额度、后端权利或用户媒体权利。辅助工具保留上游 MIT 版权声明。