Loopcut

loopcut

Claude Code、Codex、Cursor、Claude Desktop、シェル向けのLoopcutのクラウドツールです。.blend ファイルをクラウド上のRTX 4090でレンダリングしたり、無料のアセットライブラリを検索したり、画像を3Dモデルに変換したり、メッシュをリメッシュしたり、効果音や音声のセリフを作成したり、動画や文章から手持ちのリグに合わせたキャラクターアニメーションを作成したりできます。結果は、エージェントがBlenderのPythonでインポートするファイルとして返されます。料金はすべてLoopcutアカウントのクレジットで支払います。Loopcutアプリは不要です。Blenderがインストールされていれば、どの環境でもシーンをパッケージできます。

MCP サーバーと、同じ動詞を使うCLIで構成されています。ツールはLoopcutのカタログから提供されるため、Loopcutで公開されたクラウドツールは、新しいリリースなしで利用できるようになります。

ツール	内容	結果
loopcut_login	ログインまたはアカウントの切り替えを行います。初回はどのツールからでも自動的に実行され、ブラウザーが開き、承認すると呼び出しが続行されます
loopcut_account	プラン、クレジット残高、プライベートモードと生成なしの設定、利用可能なツールを確認します
render_quote	保存済みのシーンをヘッドレスBlenderでパッケージし、クラウドにないデータをアップロードして、レンダリング料金を見積もります	PNGフレームとQAレポート
asset_search	Poly Haven、ambientCG、Physically Basedを検索します。無料で、すぐに実行されます	ライセンスとダウンロードの詳細を含む検索結果
image_to_3d	プロンプト、画像、またはその両方から、テクスチャ付きモデルを作成します	GLB
remesh	GLBメッシュをクリーンな四角形または三角形で再構築し、テクスチャをベイクします	FBX（四角形）またはGLB（三角形）
sound_effect	説明から効果音を作成します	WAV
voice_line	選択した声と演技指示でセリフを読み上げます	WAV
job_start	見積もり済みのジョブを開始し、クレジットを消費します。再度呼び出すと、同じジョブが返されます
job_status	ジョブを待機し、ハッシュを検証しながら中断・再開可能な方法で結果をダウンロードします
job_cancel	ジョブをキャンセルし、未使用のクレジットを払い戻します

画像生成と画像編集は、公開されると image_generate と image_edit として利用できます。

モーション

Loopcut を開くと 2 つのモーションツールが表示されます。結果を利用するための無料のローカルツールもあります。

ツール	機能	価格	結果
motion_from_video	ローカルの MP4、MOV、WebM から、人の全身の動きを手も含めてキャプチャします（NVIDIA GEM-X）。人物は 1 人で、全身が映っており、カメラはほぼ固定されている必要があります。1 ジョブあたり最大 60 秒で、start_s と end_s で指定します。ファイルサイズは最大 200 MB です	キャプチャした秒数あたり 3 クレジット、最低 2 秒	motion.bvh + motion.json
motion_from_text	1 つの簡単な身体動作の説明から、2～10 秒の身体アニメーションを生成します（NVIDIA Kimodo、Meta Llama 3 で構築）。地に足のついた動き（歩行、ダンス、キック、ジェスチャー、その場での格闘）が得意です。宙返り、空中での回転、大きなジャンプは小さくなったり、生成されなかったりします。指は動きません。顔、小道具、指の動きには対応していません	モーションの秒数あたり 2 クレジット	motion.bvh + motion.json
motion_apply	保存済みの .blend 内のヒューマノイドリグに結果をリターゲットします。Blender をヘッドレスで実行し、ファイルを保存します。Mixamo、Rigify、Auto-Rig Pro、Unreal mannequin、またはボーン名による任意のヒューマノイドに対応します。リグがない場合は、SOMA 独自のスケルトンとシンプルなボディを使用します。無料でローカルに動作します	無料	アニメーション付きの .blend

motion.bvh はリグに依存しない SOMA 77 ジョイントスケルトンです（立位の T ポーズをレスト姿勢とし、単位はセンチメートル、Y 軸が上、30 fps）。 コネクターはクリップの長さを自動で測定します（MP4 と MOV はファイルヘッダーから、WebM は ffprobe がインストールされている場合にそれを使用します）。見積もりはキャプチャする秒数に基づくためです。モーションツールの target_armature と in_place は、motion_apply で使うためにお使いのマシン上に保持され、Loopcut に送信されることはありません。job_status は結果を返し、保存済みの .blend 用の motion_apply（または loopcut motion-apply）、すでに開いている Blender 用の短い Python スニペット（別の Blender MCP 経由など）、Blender の標準 BVH インポートという 3 つの利用方法を提示します。リターゲットには Loopcut アドオン独自の機能を使用するため、結果はアプリと同じになります。生成を無効にすると、motion_from_video は利用可能なままです（ユーザー自身の動作を記録するため）。motion_from_text は非表示になります。

価格。 1 クレジット = $0.01 です。有料ツールはすべて、最初に無料で見積もりを提示します。見積もり額はジョブの最大料金です。レンダリングは RTX 4090 で GPU 1 分あたり 5 クレジット、最低 1 分です。その他の料金は loopcut.org/pricing をご覧ください。アセット検索、見積もり、パッキング、レンダー QA レポートは無料です。失敗したジョブの料金は返金されます。新規アカウントには 100 クレジットが付与されます。

インストール

uv が必要です（Python 3.10 以降が付属しています）。レンダリングする場合は Blender も必要です。

Claude Code（エージェントにツールとクレジットを節約する使い方を教えるスキルが付属するプラグイン）

/plugin install loopcut --marketplace loopcut-ai/loopcut

Claude Code 2.1.275 より前のバージョンでは、/plugin marketplace add loopcut-ai/loopcut を実行してから、/plugin install loopcut@loopcut を実行してください。または、MCP サーバーのみを追加します。

claude mcp add loopcut -- uvx loopcut mcp

Codex（同じスキルが付属するプラグイン）

codex plugin marketplace add loopcut-ai/loopcut
codex plugin add loopcut@loopcut

または、MCP サーバーのみを追加します。

codex mcp add loopcut -- uvx loopcut mcp

各ツール呼び出しは 50 秒以内に返るため、Codex のデフォルトのツールタイムアウトである 60 秒以内に収まります。時間のかかる処理は呼び出しの合間も続行されます。どちらのプラグインも、同梱するリリースに固定された uvx loopcut==<release> mcp でサーバーを起動します。このパッケージには Python 以外の依存関係はありません。

Cursor、VS Code、Claude Desktop、その他の MCP クライアント

{
  "mcpServers": {
    "loopcut": {
      "command": "uvx",
      "args": ["loopcut", "mcp"]
    }
  }
}

Dock やスタートメニューから起動したアプリでは、シェルの PATH が参照できない場合があります。サーバーが起動しない場合は、command に which uvx で取得したフルパスを指定してください。

最初の呼び出しでブラウザーが開き、サインインを求められます。キーは、あなただけが読み取れる場所に保存されます。ブラウザーが使えない場合（たとえば SSH 経由の場合）、呼び出しは開くためのリンクを返します。LOOPCUT_API_KEY を設定すると、これらの手順をスキップできます。

CLI

loopcut login                                         # once per machine
loopcut account                                       # plan, credits, settings
loopcut tools                                         # the open tools and their inputs
loopcut render shot.blend --frames 1-120 --samples 256 --max-credits 300
loopcut run asset_search --input '{"query": "oak floor", "kind": "material"}'
loopcut run image_to_3d --input '{"prompt": "a brass desk lamp", "quality": "draft"}' --file image=lamp.png --max-credits 30
loopcut quote sound_effect --input '{"prompt": "a heavy wooden door slams", "duration_seconds": 2}'
loopcut run motion_from_video --file video=take.mp4 --input '{"static_camera": true}' --blend shot.blend --max-credits 60
loopcut run motion_from_text --input '{"prompt": "a person jumps over a puddle", "duration_s": 4}' --yes
loopcut motion-apply --blend shot.blend --bvh loopcut_outputs/JOB_ID/motion.bvh --armature Hero --in-place
loopcut motion-apply --bvh loopcut_outputs/JOB_ID --bpy        # Python for a Blender that's already open
loopcut start QUOTE_ID | status JOB_ID --wait | fetch JOB_ID --out DIR | cancel JOB_ID
loopcut settings --private-mode off                   # or on; also --no-generation on|off

uv tool install loopcut でコマンドをインストールするか、インストールせずに uvx loopcut … として任意のコマンドを実行できます。 run と render は料金を見積もり、--yes を指定するか、--max-credits N で上限を設定するか、プロンプトに回答した場合にのみ開始します。モーションツールの run に --blend を指定すると、そのシーンのリグにもモーションが適用されます。motion-apply は --out を指定しない限り、--blend のファイルを上書きして保存します（Blender は以前のファイルを .blend1 として保持します）。結果は JSON で標準出力に出力され、進行状況は標準エラー出力に出力されます。CI では、 loopcut.org/account でキーを作成し、LOOPCUT_API_KEY を設定してください。

設定

変数	意味
LOOPCUT_API_KEY	保存済みのサインイン情報の代わりに使用する Loopcut キー（lc_…）。CI などで使用します
LOOPCUT_BLENDER	パッキングおよび motion_apply に使用する Blender 実行ファイル。指定しない場合、ツールは BLENDER、次に PATH、最後に一般的なインストール先フォルダーを確認します
LOOPCUT_SERVICE_URL	サービスの URL。デフォルトは https://loopcut.org です
LOOPCUT_CONNECTOR_HOME	サインイン情報、見積もり、ジョブ、最後に使用したツールカタログの保存先です。デフォルトは ~/.config/loopcut-connector、Windows では %APPDATA%\loopcut-connector です。Loopcut アプリ独自のファイルとは別の場所です

プライベートモードと生成なしモード。 これらのアカウント設定もここで適用されます。プライベートモード（有料プランではデフォルトで有効）は、受け取ったデータをプロバイダーが学習に使用する可能性のあるツールを拒否します。現在は効果音が対象です。生成なしモードでは、生成ツールが非表示になり、使用も拒否されます。Loopcut アプリまたは loopcut settings で変更してください。

仕組み

1. 見積もり。 すべてのツールで、Loopcut アドオンが使用するのと同じジョブ API を利用します。見積もりではリクエストの料金が正確に算出され、その有効期間は 10 分です。期限切れの場合は開始時に更新され、料金が変わっていない場合にのみジョブが実行されます。同じ見積もりを 2 回開始すると、同じジョブが返されます。
2. ファイルの入力。 ファイル入力にはローカルパスを指定します。ファイルは検証（種類とサイズ）され、SHA-256 で識別されます。クラウドにまだないファイルのみ、署名付き URL を使ってストレージへ直接アップロードされます。大きなファイルは分割し、それぞれ個別に再試行します。
3. レンダリング用のパッケージ化。 バックグラウンドの Blender（-b --factory-startup --disable-autoexec）で保存済みの .blend を開き、Loopcut アドオン独自のコレクター（vendored の addon/bundles.py）を実行します。すべてのテクスチャ、ライブラリ、キャッシュ、シーケンサーのファイルを、相対パスを保持したままバンドルにコピーします。この Blender には専用の設定フォルダーが割り当てられ、環境のキーは一切渡されません。クラウドでファイル内の Python が実行されることはなく、レンダラーからインターネットにアクセスすることもできません。
4. ファイルの出力。 結果はハッシュと照合して検証され、レンダリングの場合は .blend と同じ場所にある loopcut_renders/<job_id>/ に、それ以外の場合は作業フォルダー内の loopcut_outputs/<job_id>/（または out_dir）に保存されます。作業フォルダーは、クライアントが共有している場合はそのワークスペースのルートです。Codex はプラグインサーバーをプラグイン自身のフォルダーで起動するため、その場合、結果は代わりにホームフォルダーに保存されます。レンダリングの QA レポートでは、黒、白、平坦、透明なフレーム、ファイアフライ、重複フレーム、露出の急変が報告されます。
5. モーションをリグに適用。 motion_apply は保存済みの .blend を使って同種のバックグラウンド Blender を起動し、loopcut/motion_blender.py 経由でアドオンのリターゲッター（vendored の addon/motion_retarget.py）を実行します。処理内容は、全身のレスト姿勢のアラインメント、A ポーズのリグに対する四肢のみの方向アラインメント、脚の長さに合わせた骨盤の軌道のスケーリング、親から先に行うキーの書き込みです。リグ上の以前のアクションは、ミュートされた NLA トラックに保持されます。データがマシンの外に送信されることはなく、費用もかかりません。

起動時にカタログを読み込めない場合、サーバーはそのサービスから最後に読み込んだカタログを使用し、それもない場合は src/loopcut/catalog.json のスナップショットを使用します。

実行するものと接続先。 Python を提供する uv（必要に応じて Python をダウンロードします）、シーンを render_quote 用にパッケージ化するときと motion_apply でモーションを適用するときに限って使用する Blender（ヘッドレス）、インストールされている場合に WebM クリップの計測にのみ使用する ffprobe、Loopcut のサインインページを開くときにのみ使用するブラウザーです。loopcut.org（カタログ、サインイン、ジョブ API）と、その API からアップロードおよびダウンロード用に提供される署名付きストレージ URL に接続します。アナリティクスは送信しません。

プライバシーポリシー

Loopcut のプライバシーポリシーは loopcut.org/privacy をご覧ください。このコネクターについては、以下のとおりです。

• 送信される情報。 すべてのリクエストで、クライアントの名前とバージョンとともに Loopcut のキーが送信されます。レンダリングの場合、パックされたシーン、つまり保存済みの .blend と、それが使用するすべてのテクスチャ、ライブラリ、キャッシュが送信されます。それ以外のツールでは、あなたまたはエージェントが指定した入力（プロンプト、設定）と、入力として指定されたファイル（画像、メッシュ、動画）が送信されます。マシン上のそれ以外の情報は読み取りません。他のファイルや、LOOPCUT_API_KEY 以外の環境キー、開いている Blender セッションも読み取りません。motion_apply は、マシン上で指定された .blend のみを開いて保存します。また、target_armature と in_place もローカルにとどまります。
• 保存場所。 Loopcut のデータベース（米国の Supabase）にはアカウント、見積もり、ジョブが保存され、アップロードしたファイルと結果は Cloudflare R2 に保存されます。
• 第三者。 各ジョブは、実行を担うプロバイダーにのみ送信されます。現在は OpenAI、fal と同社が利用するモデル開発元（Rodin の Deemos、Tripo）、Google Cloud、ElevenLabs、RunPod です。プロバイダー独自のデータ保持条件はプライバシーページに記載されています。有料プランではデフォルトでプライベートモードが有効になっており、受信したデータを学習に使用する可能性のあるプロバイダーのツールは拒否されます（現在は効果音が該当します）。
• 保持期間。 アップロードしたファイルは最後に使用されてから7日後に削除され、結果は最後に使用されてから30日後に削除されます。アカウントと請求の記録は、アカウントが存在する間保持されます。ダウンロードした結果は、マシン上の通常のファイルです。
• マシン上の保存情報。 キー、見積もり、ジョブ、最後に取得したツールカタログは ~/.config/loopcut-connector に保存され、あなたのみが読み取れます。loopcut logout を実行するとキーが削除されます。
• お問い合わせ。 [email protected] までご連絡ください。アカウントデータのエクスポートや削除についてもお問い合わせいただけます。

開発

PYTHONPATH=src python3 -m unittest discover -s tests       # MCP protocol and unit tests
LOOPCUT_TEST_BLENDER=/path/to/blender PYTHONPATH=src python3 -m unittest tests.test_blender_pack
python3 scripts/snapshot_catalog.py                         # refresh the fallback catalog before a release

エンドツーエンドテストは、サービスリポジトリにある Loopcut のコントラクトモックに対して実行されます。このリポジトリではスキップされます。アドオンのコピーを同期させる方法については、addon/VENDORED.md をご覧ください。

GPL-3.0-or-later のもとでリリースされています。Loopcut は独立したプロジェクトです。Blender は Blender Foundation の商標です。