Instavar Video Templates and Studio

@instavar/mcp-server

一个 MCP 包，从免费开始，随工作需求不断扩展。无需账号或 API 密钥，即可在 Claude Code 或 Codex 中使用 Instavar 独立开源的 Remotion 模板制作本地视频。

Instavar 是一个独立项目，与 Remotion AG 无关联，未获其赞助或认可。 Remotion 是 Remotion AG 的商标。

需要使用托管工作流时，添加 Instavar API 密钥： 创建 → 渲染 → 审核 → 发布 → 指标。经过身份验证的工具是用于连接托管 Instavar API 的轻量 HTTP 客户端。该包不含数据库 连接，也不会存储自身数据。你可以继续使用免费工具，无需安装第二个服务。

选择合适的功能

当 Agent 需要可重复使用的 Remotion 视频模板、创意指导、VideoSpec 示例，或本地渲染错误排查帮助时，请使用 Instavar。 先调用 get_capabilities，然后在起草文案或设计前调用 get_creative_guide。 使用 list_templates 和 get_template 选择受支持的结构，再通过 get_example 或 scaffold_video_spec 准备其规格。 get_render_instructions 会提供独立的本地验证、预览和渲染工作流。 规划和搭建脚手架不会渲染、上传或发布媒体。

更倾向于使用基于浏览器的 Agent 连接托管 HTTP？请使用 https://instavar.com/api/mcp/templates，该服务也列为 Smithery 上的 Instavar 视频模板。 这个相关端点还支持分镜脚本和编辑型轮播内容的规划。其可选 OAuth 工具仅用于列出和查看私有项目。它与此 npm 包或完整的受保护 Studio 端点并不相同。公开规划无需 Instavar 账号；目录或网关可能需要单独登录。

托管 Studio 制作是可选的，且可能产生费用。绝不要将规划视频的请求视为渲染付费任务或发布社交媒体帖子的许可。

使用哪个模型运行？

MCP 宿主提供通用大模型。

• 在 Claude Code 中，所选的 Claude 模型会解读请求并调用 Instavar 工具。
• 在 Codex 中，所选的 OpenAI 模型会解读请求并调用相同的工具。
• 其他兼容宿主使用各自选定的模型和身份验证方式。

MCP 服务不提供 Sonnet、GPT 或其他通用模型。它向用户宿主中已运行的模型提供类型化的 Instavar 功能。具体取决于宿主和登录方式，模型用量可能计入个人或工作区订阅、单独的用量额度，或 API 账单。这些服务提供商规则可能会变更。

本地 Remotion 渲染使用你自己的设备。Instavar 会对其托管服务计量或收费，包括渲染、存储、专业媒体生成、QA、发布以及其他明确列出的任务费用。使用基于订阅的 Agent 并不会让这些服务免费。

如需查看公开的设置指南和示例，请参阅 Instavar 视频模板。

设置

将服务添加到 MCP 客户端配置中：

{
  "mcpServers": {
    "instavar": {
      "command": "npx",
      "args": ["-y", "@instavar/mcp-server"]
    }
  }
}

此配置会启用免费的本地模板工具。要启用托管 Studio 工具，请在 https://instavar.com/studio/settings 创建 API 密钥，然后添加该密钥：

{
  "mcpServers": {
    "instavar": {
      "command": "npx",
      "args": ["-y", "@instavar/mcp-server"],
      "env": { "INSTAVAR_API_KEY": "ik_live_..." }
    }
  }
}

重启客户端。两种模式下都会显示免费工具。配置密钥后，才会显示托管工具。

环境

变量	必需	默认值	用途
INSTAVAR_API_KEY	否	—	解锁托管 Studio 工具。仅限你的组织使用；可撤销。
INSTAVAR_BASE_URL	否	https://instavar.com	覆盖 API 主机。

工具

从 npm 0.6.0 起，软件包还包含 prepare_announcement：用于 Remotion 和 HyperFrames 的配套公告卡片。它会返回本地源文件和可移植的复制文档，而不是已保存的托管项目或渲染后的视频。如果未指定框架，请询问用户；继续使用最近返回的项目以及匹配的 expectedRevision。切换框架时，只有标题、正文和操作会保留。

免费本地工具：

工具	功能
get_capabilities	报告免费功能和可选账户功能。
get_creative_guide	提供简明的文案、故事、设计和审阅指南。
list_templates	列出已发布的 Remotion 模板系列。
get_template	返回一个模板契约。
get_video_schema	返回公开的 VideoSpec JSON Schema。
get_example	返回一个 VideoSpec 入门示例。
scaffold_video_spec	创建确定性的 VideoSpec 骨架。
get_render_instructions	返回本地验证和渲染工作流。
diagnose_render_error	对常见的本地渲染故障进行分类。

配置 INSTAVAR_API_KEY 后可用的托管工具：

工具	功能说明
list_jobs	列出最近的任务（按时间从新到旧）。
get_job_status	获取运行情况、制品、验证结果，以及当前视频和缩略图的 URL。
get_video_state	获取任务的物化合成状态。
diagnose_render	只读的渲染联合诊断，包含证据限制和重试建议。
get_job_metrics	获取已发布任务的平台互动数据快照。
get_cost_summary	获取基础设施成本汇总（Lambda / RunPod / R2 / WaveSpeed / PoYo）。
inspect_workflow	查看当前工作流及其版本历史。
create_video_brief	根据结构化简报创建任务并开始渲染。
edit_video_brief	修改简报（包括 objective / publishTarget）；除非只修改 publishTarget，否则会重新渲染。
retry_video_qa	针对同一份当前冻结的视频制品，重试状态降级或不可用的 QA。
audit_video_qa	针对同一份冻结视频，运行 Qwen3.6-Plus 顾问式第二意见。
regenerate_narration	根据未更改的持久化简报重新生成旁白及其依赖的视频。
draft_workflow	使用已检查的 expectedVersion 保存完整工作流（仅在不存在版本时使用 0）。
patch_workflow	根据递归补丁创建可处理冲突的工作流版本。
validate_workflow	验证并编译已检查的工作流版本，不进行渲染。
preview_workflow	查看编译后的 UniversalVideo 简报，不进行渲染。
compare_workflows	逐字段比较两个持久化工作流版本。
approve_workflow	批准已检查的有效版本，但不批准或发布视频任务。
approve_job	批准已渲染的任务，使其可以发布。
publish_job	将已批准的任务发布到已连接的社交平台。
connect_account	开始连接社交账号（无头 OAuth 配对）。
connect_account_status	轮询待处理的账号连接，直到连接成功。

工作流检查、预览和比较需要 read 权限。工作流草拟、补丁、验证和批准需要 write 权限。publish_job 需要 publish 权限。

工作流工具会拒绝未知参数，而不是静默丢弃。API 调用会在 15 秒后超时。版本过期时返回的 409 会告知调用方检查最新版本；如果是上传不可用或其他依赖项冲突，则会告知调用方先解决该依赖项再重试。

从终端连接社交账号

connect_account 会返回一个批准 URL和一个简短的确认码。在已登录 Instavar 的浏览器中打开该 URL，确认代码与终端中显示的代码一致，然后批准——你会先通过平台的常规登录流程，再返回 Instavar。使用返回的 pairingId 轮询 connect_account_status，直到其报告 connected。配对会在 10 分钟后过期，且只有工作区所有者或管理员可以批准。

CLI

npx @instavar/mcp-server --version
npx @instavar/mcp-server --help

许可证

MIT

创意指南

get_creative_guide 无需密钥即可使用。省略 guideId 可查看四份指南，也可以选择 visual-copy、carousel-stories、visual-design 或 human-review。相同文本也可通过 Markdown 资源 instavar://creative-guides/<guideId> 获取。调用工具的助手会根据用户的简述应用这些指南；此工具不会生成文案、渲染、保存反馈或发布媒体。轮播图方案是规划指南，不是额外的 npm 渲染器。

单体仓库中的源文件位于 docs/guides/creative/。编辑后，运行 node scripts/build-creative-guides.mjs；--check 会拒绝过时的构建产物。生成的 TypeScript 会打包进程序包，因此已安装的客户端无需检出文件，也无需访问私有知识库。源文件变更需要经过常规 npm 发布，已安装的客户端才能收到更新。