HyperCodeMotion MCP

HyperCodeMotion MCP

将 Claude 连接到 HyperCodeMotion，这是一款用于数据驱动动态图形的编辑器。Claude 负责设计动画；此连接器会检查动画，并将其转换为 .hcmotion 项目，你可以在 HyperCodeMotion Studio 中打开项目，自行修改文本、颜色、时间和顺序，而不必让 AI 重新生成所有内容。

• MCP 端点： https://mcp.hypercodemotion.com/mcp（远程服务，可流式传输的 HTTP）
• 身份验证： 无。该服务没有账户，也不会读取你的 Claude 账户中的任何数据。
• Studio： app.hypercodemotion.com

在 Claude 中使用

1. 在 Claude 中，打开 Settings → Connectors，然后选择 Add custom connector。
2. 将其命名为 HyperCodeMotion，并粘贴 https://mcp.hypercodemotion.com/mcp。
3. 在聊天中，通过工具菜单启用此连接器。
4. 请求制作动画，或粘贴从 HyperCodeMotion Studio 复制的提示词（«Crear con IA» → «Generar prompt»）。
5. Claude 会回复两个链接：
   • 打开： 直接在 HyperCodeMotion Studio 中打开项目。
   • 下载： .hcmotion 文件，你也可以从 Studio 主屏幕打开它（«Cargar proyecto»）。

两个链接在创建 24 小时 后过期。请从 Studio 保存项目（Archivo → Guardar proyecto）以保留它。

提示词示例

• “为 Nimbus（一款带 AI 的笔记应用）制作一段 15 秒的竖屏发布视频，并提供 HyperCodeMotion 项目。”
• “制作一段 10 秒的说明视频，分三个步骤介绍如何冲煮手冲咖啡，画面比例为 16:9，并将其打包为 HyperCodeMotion 项目。”
• “HyperCodeMotion 支持哪些图层类型和特效？”

工具

工具	功能	注释
get_capabilities	列出 Studio 支持的格式、图层类型、图层属性和效果预设，说明如何通过 ID 引用用户保存在 Studio 中的文件（照片、徽标、视频片段），说明决定字号的屏幕规则、用于保留并播放现有 Lottie、glTF 或 GSAP 文件的运行时图层，以及这些内容所属的 Studio 版本。	只读
create_hcmotion	验证已完成的合成，并将其打包为 .hcmotion 文件。输入无效时会返回 created: false，并列出需要修正的错误，不会存储任何内容。输入有效时会返回 open 和 download 链接（有效期 24 小时）。	写入（创建临时文件），非破坏性
get_template	根据模板 ID 和格式返回 Studio 画廊模板的完整设计（简介、场景、HTML 场景文档和图层），供设计参考。	只读
validate_json	检查合成、设计或改进补丁，并返回错误和警告。拒绝无法容纳在画布内的可测量文本，以及行高小于 1 的内容。不能保证渲染正确。	只读
get_recreation_brief	接收公开动态视频的链接（prompt-motion.com 或 oneshotted.io）和版主代码（只有版主才能制作画廊模板），以及 Claude 在该页面上读取的视频文件、提示词、标题和作者（源网站经常会拒绝服务器），并返回视频的来源详情、可用时的已发布提示词、将其重制为画廊模板的简介，以及原视频的参考帧（每个视频只提取一次；首次调用可能会提示正在准备）。prompt-motion.com 会拒绝所有服务器，因此对于其视频，该简介会返回一段简短脚本，由 Claude 在自己的代码工具中运行（或在浏览器工具中执行相同步骤），以下载视频并分段发送到此处。	写入（启动帧提取），非破坏性
propose_template	使用版主代码提交重制内容（三个合成和画廊卡片）。检查来源、合成和卡片；通过后，使用 Studio 引擎按原视频格式渲染合成，并逐帧与原视频进行比较。可使用相同代码提交修正（最多比较 3 次）。返回跟踪代码。	写入，非破坏性
get_proposal_status	根据跟踪代码返回提案状态：比较中、审核中（附比较表：原版和重制版并排显示）、渲染中、已发布（附画廊 ID、分支和提交），失败（附原因）或已退回。	只读
publish_template	使用版主代码和有关有意保留的原版差异的说明，将已比较的提案发布为官方 Studio 模板：Studio 工作流会渲染画廊媒体，并将其提交到 Studio 代码（TEMPLATE_BRANCH）。	写入，非破坏性

重制本身会在用户自己的 Claude 对话中完成；连接器提供简介和参考帧，并返回与原版的比较结果。它不会为用户渲染视频、使用 AI 模型生成图像、音频或视频，也不会访问请求中未包含的任何内容。

数据与隐私

• get_capabilities、get_template、validate_json 和 get_proposal_status 不会存储任何内容。
• get_recreation_brief 会将公开视频的参考帧存储在私有存储中（绝不会公开），以便将复刻结果与其进行比较。
• propose_template 会存储提案、卡片及其来源链接（不含个人数据），直到版主发布提案；发布后，提案会提交到 Studio 代码中。系统会保留版主姓名的加盐哈希 1 天，以限制每位版主每天最多提交 20 个提案。
• create_hcmotion 会将生成的文件存储在私有 Vercel Blob 存储中。任何获得链接的人都可以下载文件，直到链接在 24 小时后过期；每日任务会删除过期文件（最迟约在文件创建 48 小时后删除）。
• 不会使用账户、Cookie 或跟踪，也不会使用你的内容训练 AI。

画廊模板（设置）

版主将 prompt-motion.com 或 oneshotted.io 视频的链接和版主代码发送给 Claude，就足以让 Claude 复刻、比较并发布视频。Studio 仓库的 community-render 工作流会提取参考帧、渲染对比内容（对比图和 comparacion.mp4；版主可使用代码作为 Bearer，在 GET /api/community?op=compare&id=c-…&file=comparacion.mp4 访问），并在发布时（kind: official）渲染画廊媒体、在其独立分支 plantilla/<slug> 上将模板提交到 apps/studio/public，然后向 TEMPLATE_BRANCH（默认为 template）创建拉取请求。这样，每个模板都有自己的预览，供审核批准或弃用：plantillas/<slug>-<variant>.json、bienvenida/ejemplos/<slug>-<ratio>.{mp4,jpg} 以及画廊中的对应卡片。此 Vercel 项目中的环境变量：GITHUB_DISPATCH_TOKEN（仅具有 jasp402/HyperCodeMotion 上 Contents: read and write 权限的细粒度令牌，仅用于启动该工作流）；不会与工作流共享密钥：回调会携带 GitHub 的 OIDC 令牌（受众为 hypercodemotion-mcp，仓库为 RENDER_REPO，默认为 jasp402/HyperCodeMotion），并在此处通过 GitHub 的密钥进行校验（设置了 COMMUNITY_RENDER_SECRET 时仍会接受该密钥）；TEMPLATE_ADMIN_CODES 或 COMMUNITY_ADMIN_SECRET（版主代码：一个代码，或 name:code, name:code；少于 6 个字符的代码会被忽略）；以及可选的 TEMPLATE_BRANCH。

完整详情：隐私政策 · 服务条款 · 支持

支持

发送邮件至 [email protected]（也可联系 [email protected]），或提交 GitHub issue。Issue 是公开的：切勿发布密码、令牌或机密项目内容。

开发者须知

协议

服务器通过 HTTP POST 使用 JSON-RPC 2.0（initialize、ping、tools/list、tools/call）。对端点发送 GET 请求会返回 405 和简短说明，这是预期行为。请求正文大小上限为 4 MB。

.hcmotion 布局

偏移量	大小	内容
0	3	HCM（ASCII）
3	1	格式版本（1）
4	1	标志（位 0：gzip）
5	3	保留（0）
8	4	JSON 大小，未压缩（u32 LE）
12	4	数据大小（u32 LE）
16	32	数据的 SHA-256
48	n	合成 JSON，gzip

文件未加密：SHA-256 仅用于检测文件是否被截断或编辑。Studio 在 packages/core/src/hcmotion.ts 中实现了相同的布局。

文件可通过 https://mcp.hypercodemotion.com/d/<id> 访问，并可在 Studio 中通过 https://app.hypercodemotion.com/?p=<id> 打开。24 小时后，链接会返回 410。

部署设置

• 已连接到 Vercel 项目的私有 Blob 存储。通过 OIDC 进行身份验证（BLOB_STORE_ID + 项目的 OIDC 令牌）；也支持 BLOB_READ_WRITE_TOKEN。
• 设置 CRON_SECRET，确保只有 Vercel Cron 可以调用 /api/cleanup。
• 可选的 PUBLIC_URL / STUDIO_URL（默认值分别为 https://mcp.hypercodemotion.com / https://app.hypercodemotion.com）。

测试

npm test          # unit and integration tests
npm run test:live # smoke test against production

GitHub Actions 会运行这两项测试。两者都不能保证与 Studio 完全兼容渲染。

功能快照

目录根据 Studio 源文件（packages/core/src/schema.ts、packages/core/src/presets.ts）生成，Studio 有更改时必须进行审核。

HyperCodeMotion Creative Skill

该仓库还包含 HyperCodeMotion Agent Skill，可指导 AI 助手从简报着手，完成艺术指导、场景、可编辑 JSON 和 .hcmotion 交付。它与连接器分开分发，不会仅仅因为连接器已连接就自动启用。

许可证

源代码采用 Apache License 2.0。托管服务受 Terms of Service 约束。HyperCodeMotion 名称和徽标不受软件许可证授权。