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 から 2 つのリンクが返されます。
   • 開く：プロジェクトを HyperCodeMotion Studio で直接開きます。
   • ダウンロード：.hcmotion ファイルをダウンロードします。このファイルは Studio のホーム画面（「Cargar proyecto」）からも開けます。

どちらのリンクも、作成から 24 時間 で期限切れになります。プロジェクトを保存するには、Studio で「Archivo → Guardar proyecto」を選びます。

プロンプトの例

• 「Nimbus という AI 搭載メモアプリの 15 秒の縦型ローンチ動画を作成して、HyperCodeMotion プロジェクトも用意してください。」
• 「ハンドドリップコーヒーの淹れ方を 3 つの手順で説明する 10 秒の動画を作成し、アスペクト比は 16:9 にして、HyperCodeMotion 用にまとめてください。」
• 「HyperCodeMotion はどのレイヤータイプとエフェクトに対応していますか？」

ツール

ツール	機能	注釈
get_capabilities	Studio がサポートする形式、レイヤーの種類、レイヤーのプロパティ、エフェクトのプリセット、Studio に保存されているユーザーのファイル（写真、ロゴ、動画クリップ）を ID で参照する方法、文字サイズを決める画面ルール、既存の Lottie、glTF、GSAP ファイルを保持してシークするランタイムレイヤー、およびこれらの情報の基となる Studio のリビジョンを一覧表示します。	読み取り専用
create_hcmotion	完成したコンポジションを検証し、.hcmotion ファイルとしてパッケージ化します。入力が無効な場合は、修正すべきエラーとともに created: false を返し、何も保存しません。入力が有効な場合は、open と download のリンク（24 時間有効）を返します。	書き込み（一時ファイルを作成）、破壊的ではありません
get_template	ID と形式（brief、シーン、HTML シーンドキュメント、レイヤー）で指定された Studio ギャラリーテンプレートのデザイン全体を返します。デザインの参考として使用できます。	読み取り専用
validate_json	コンポジション、デザイン、改善パッチを確認し、エラーと警告を返します。測定可能なテキストがキャンバスに収まらない場合や、行の高さが 1 未満の場合は拒否します。正しくレンダリングされることを証明するものではありません。	読み取り専用
get_recreation_brief	公開モーション動画のリンク（prompt-motion.com または oneshotted.io）とモデレーターコード（ギャラリーテンプレートを作成できるのはモデレーターのみ）、さらに動画ファイル、プロンプト、タイトル、Claude がそのページで読み取る作者名を受け取り（ソースサイトがサーバーからのアクセスを拒否することがよくあります）、ソースの詳細、公開されている場合はそのプロンプト、ギャラリーテンプレートとして再現するためのブリーフ、元動画の参照フレームを返します（動画ごとに一度だけ抽出されます。初回の呼び出しでは、準備中であることを示す応答が返る場合があります）。prompt-motion.com はすべてのサーバーからのアクセスを拒否するため、同サイトの動画では、Claude が自身のコードツール（またはブラウザツールで同じ手順）を実行して動画をダウンロードし、分割してここに送信するための短いスクリプトをブリーフに含めます。	書き込み（フレーム抽出を開始）、破壊的ではありません
propose_template	モデレーターコードを使って、再現内容（3 つのコンポジションとギャラリーカード）を送信します。ソース、コンポジション、カードを確認し、承認されると、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件までに制限するため、1日間保持されます。
• create_hcmotion は、生成されたファイルをプライベートな Vercel Blob ストアに保存します。リンクを知っている人は誰でも、24時間後に期限切れになるまでダウンロードできます。1日ごとのジョブで期限切れのファイルを削除します（作成から最大約48時間後までに削除されます）。
• アカウント、Cookie、トラッキング、コンテンツを使った AI のトレーニングはありません。

ギャラリーテンプレート（セットアップ）

モデレーターが Claude に prompt-motion.com または oneshotted.io の動画リンクとモデレーターコードを送れば、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 トークン（audience は hypercodemotion-mcp、repository は RENDER_REPO、既定値は jasp402/HyperCodeMotion）が含まれ、ここで GitHub のキーを使って検証されます（COMMUNITY_RENDER_SECRET は設定されている間は引き続き使用できます）。TEMPLATE_ADMIN_CODES または COMMUNITY_ADMIN_SECRET（モデレーターコード：1つのコード、または 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 も使用できます。
• Vercel Cron のみが /api/cleanup を呼び出せるようにする CRON_SECRET。
• 任意の 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

このリポジトリには、AI アシスタントが概要からアートディレクション、シーン、編集可能な JSON、.hcmotion の引き継ぎまでを進めるための HyperCodeMotion Agent Skill も含まれています。これはコネクターとは別に配布されており、コネクターに接続しただけでは有効になりません。

ライセンス

ソースコード：Apache License 2.0。ホスト型サービスには利用規約が適用されます。HyperCodeMotion の名称およびロゴは、ソフトウェアライセンスの対象ではありません。