Loopcut

loopcut

Loopcut 为 Claude Code、Codex、Cursor、Claude Desktop 和 shell 提供云端工具。在云端 RTX 4090 上渲染 .blend 文件、搜索免费素材库、将图像转换为 3D 模型、重新网格化网格、制作音效和语音台词，以及将视频或句子转换为适用于你自己的骨架的角色动画。结果会以文件形式返回，由 Agent 使用 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 的形式出现。

Motion

在 Loopcut 上打开后，会出现两个运动工具，并提供一个可免费在本地使用结果的工具：

工具	功能	价格	结果
motion_from_video	从本地 MP4、MOV 或 WebM 文件中捕捉一个人的全身动作，包括手部动作（NVIDIA GEM-X）。画面中只能有一个人，且全身都要入镜；摄像机基本保持静止；每个任务最长 60 s，可通过 start_s 和 end_s 选择片段，文件最大 200 MB	每捕捉一秒需 3 个点数，最低 2 秒	motion.bvh + motion.json
motion_from_text	根据对一个简单肢体动作的描述，生成 2–10 s 的身体动画（NVIDIA Kimodo，基于 Meta Llama 3 构建）。擅长贴近现实的动作（走路、跳舞、踢腿、手势、原地打斗）；翻转、空中旋转和大幅跳跃的动作会变小或缺失。手指保持静止；不适用于面部、道具或手指动作	每秒动画需 2 个点数	motion.bvh + motion.json
motion_apply	使用你的 Blender，将结果重定向到已保存的 .blend 中的人形骨架，并保存文件。支持 Mixamo、Rigify、Auto-Rig Pro、Unreal mannequin，或任何通过骨骼名称定义的人形骨架；没有骨架时，则使用 SOMA 自带的骨架和简易身体。免费且在本地运行	免费	已加入动画的 .blend

motion.bvh 是与骨架无关的 SOMA 77 关节骨架（站立 T 字形静止姿势，单位为厘米，Y 轴朝上，30 fps）。 连接器会自行测量片段长度（MP4 和 MOV 从文件头读取；安装了 ffprobe 时则用它读取 WebM），因为报价取决于捕捉的秒数。运动工具中的 target_armature 和 in_place 会保留在你的机器上，供 motion_apply 使用，不会发送给 Loopcut。job_status 会返回结果，并提供三种使用方式：使用 motion_apply（或 loopcut motion-apply）处理已保存的 .blend；提供一段简短的 Python 代码片段，供已打开的 Blender 使用（例如通过另一个 Blender MCP）；以及使用 Blender 自带的 BVH 导入功能。重定向由 Loopcut 插件自行完成，因此结果与应用中的效果一致。启用禁止生成模式后，motion_from_video 仍可用（它会记录用户自己的动作），而 motion_from_text 将被隐藏。

价格。 1 个点数 = $0.01。所有付费工具都会先免费报价，且报价就是任务的最高费用。在 RTX 4090 上渲染每 GPU 分钟需 5 个点数，最低按一分钟计费；其他价格请参阅 loopcut.org/pricing。素材搜索、报价、打包和渲染 QA 报告均免费。失败的任务会退还点数。新账户会获得 100 个点数。

安装

你需要 uv（它提供 Python 3.10+）；如果要渲染，还需要 Blender。

Claude Code（插件，包含一个技能，用于教 Agent 如何使用工具，以及如何养成节省点数的习惯）

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

在 2.1.275 之前的 Claude Code 版本中，请运行 /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 s 内返回，低于 Codex 默认的 60 s 工具超时；较长的任务会在调用间继续运行。两个插件都会使用 uvx loopcut==<release> mcp 启动服务，并固定为随插件发布的版本；该软件包除了 Python 外没有其他依赖项。

Cursor、VS Code、Claude Desktop 和其他 MCP 客户端

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

从 Dock 或“开始”菜单打开的应用可能无法读取 shell 的 PATH。如果服务无法启动，请将 which uvx 返回的完整路径用作 command。

首次调用会打开浏览器供你登录，密钥会保存在只有你能读取的位置。如果没有浏览器（例如通过 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 或你回答提示后才会启动。对运动工具使用带 --blend 的 run，还会将运动应用到该场景的 rig；motion-apply 会覆盖 --blend 指定的文件（Blender 会将之前的文件保留为 .blend1），除非你指定 --out。结果以 JSON 格式输出到 stdout；进度输出到 stderr。在 CI 中，请在 loopcut.org/account 创建密钥，并设置 LOOPCUT_API_KEY。

设置

变量	含义
LOOPCUT_API_KEY	Loopcut 密钥（lc_…），用于替代已保存的登录信息，例如在 CI 中使用
LOOPCUT_BLENDER	用于打包和 motion_apply 的 Blender 可执行文件。未设置时，工具会依次检查 BLENDER、PATH，然后检查常见的安装目录
LOOPCUT_SERVICE_URL	服务地址，默认为 https://loopcut.org
LOOPCUT_CONNECTOR_HOME	保存登录信息、报价、任务和最近一次工具目录的位置。默认值：~/.config/loopcut-connector；在 Windows 上为 %APPDATA%\loopcut-connector。此目录与 Loopcut 应用自身的文件分开

隐私模式和禁用生成。 这些账户设置在此处同样适用。隐私模式（付费方案默认开启）会拒绝使用可能会通过接收的数据进行训练的提供商提供的工具；目前这类工具是音效工具。禁用生成会隐藏并拒绝生成类工具。请在 Loopcut 应用中更改这些设置，或使用 loopcut settings。

工作原理

1. 报价。 每个工具都使用 Loopcut 插件所用的同一套任务 API。报价会为确切的请求定价，有效期为 10 分钟；过期后会在启动时续期，只有价格未变，任务才会继续。两次启动同一份报价会返回同一个任务。
2. 输入文件。 文件输入为本地路径。系统会检查文件类型和大小，按 SHA-256 寻址，只有云端尚未保存的文件才会通过预签名 URL 直接上传到存储空间。大文件会分块上传，每个分块都会单独重试。
3. 打包渲染内容。 后台 Blender（-b --factory-startup --disable-autoexec）会打开已保存的 .blend 文件，并运行 Loopcut 插件自带的收集器（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 运行插件自带的重定向工具（addon/motion_retarget.py，随项目提供）：进行一次全身静止姿势对齐；针对 A 字形姿势骨架，仅对四肢进行方向对齐；按腿长缩放骨盆轨迹；并按父级优先写入关键帧。骨架上原有的动作会保留在静音的 NLA 轨道中。所有处理都在你的设备上进行，而且不收费。

如果启动时无法读取目录，服务器会使用上次从该服务读取的目录，然后再使用 src/loopcut/catalog.json 中的快照。

运行和连接的内容。 uv，用于提供 Python（必要时会下载）；你的 Blender（无界面），仅用于为 render_quote 打包场景以及通过 motion_apply 应用动作；ffprobe，如果已安装，仅用于测量 WebM 片段；以及你的浏览器，仅用于打开 Loopcut 登录页面。它会连接到 loopcut.org（目录、登录和任务 API），以及该 API 提供用于上传和下载的预签名存储 URL。它不会发送任何分析数据。

隐私政策

Loopcut 的隐私政策见 loopcut.org/privacy。对于此连接器：

• 发送的内容。 每个请求都会发送 Loopcut 密钥，以及客户端的名称和版本。对于渲染，会发送打包后的场景：已保存的 .blend 文件，以及它使用的每个纹理、库和缓存。对于其他工具，会发送你或 Agent 提供的输入（提示词、设置），以及列为输入的文件（图像、网格、视频）。它不会读取你设备上的任何其他内容：不会读取其他文件、除 LOOPCUT_API_KEY 以外的环境密钥，也不会读取已打开的 Blender 会话。motion_apply 仅在你的设备上打开并保存你指定的 .blend 文件，target_armature 和 in_place 也都只在本地处理。
• 存储位置。 Loopcut 的数据库（Supabase，美国）保存你的账户、报价和任务；上传的文件和结果保存在 Cloudflare R2 中。
• 第三方。 每个任务只会发送给负责执行的服务提供商：目前包括 OpenAI、fal 及其运行的模型开发者（Deemos for Rodin、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 的商标。