CC

cartwhl/cartwheel-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

20 stars 1 forks 质量 72 趋势 30MIT

从MCP客户端生成Cartwheel 3D动画,配合Blender示例和制作设置攻略。

概览

Cartwheel MCP 将你的 AI 助手连接到 Cartwheel 的公开 API。从文本或图片创建角色,上传并自动绑定你的模型,然后对其进行动画制作。通过文字生成身体运动,使用动作编辑器控制约束,或使用 Comic 4 捕捉最多四名表演者,包括面部动画。编辑表演时可添加路径和姿势,循环或缝合剪辑,测量动作元数据,并运行捆绑的 Three.js 游戏参考。 通过角色生成和自动绑定处理三段文本描述,结合Comic 4的表演与摆动剪辑行走,然后渲染一个带有四个摄像机镜头和青蛙特写的微型天空通道。示例包括三个绑定的素材、精确提示、可复现的Blender脚本,以及复查过的肩膀、面部和高斯脚接触修正。 观看灯笼港 ·重建场景 ·创建并自动绑定角色 - 以及 Git。- 以及一个项目 API 密钥。请检查当前的计划;并非每个计划都包含 API 访问权限。

概述(AI 翻译)

创建并自动绑定角色。生成、捕捉并编辑他们的动作。

Cartwheel MCP 将你的 AI 助手连接到 Cartwheel 的公共 API。从文本或图片创建角色,上传并自动绑定自己的模型,然后进行动画制作。用 swing-edit 从文本生成身体动作,用 Motion Editor 控制限制,或用 Comic 4 捕捉最多四名表演者,包括面部动画。编辑表演时有路径和姿势,循环或缝合剪辑,测量动作元数据,并运行捆绑的 Three.js 游戏参考。

观看Blender演示 ·生产设置攻略 ·MCP搅拌机工作流程 ·更多Blender示例

三个生成角色,一个Blender场景

灯笼移植通过角色生成和自动绑定处理三段文本描述,结合了Comic 4的表演与摆动剪辑行走,然后渲染一个带有四个镜头和青蛙特写的微型天空通道。示例包括三个绑定的素材、精确提示、可复现的Blender脚本,以及审查过的肩膀、面部和高斯脚部接触修正。

观看灯笼港 ·重建场景 ·创建并自动绑定角色

你需要什么

  • **节点。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Cartwheel MCP

Create and auto-rig characters. Generate, capture and edit their motion.

Cartwheel MCP connects your AI assistant to Cartwheel’s public API. Create a character from text or an image, upload and auto-rig your own model, then animate it. Generate body motion from text with swing-edit, constrain it with Motion Editor controls, or capture up to four performers from a video with Comic 4, including facial animation. Edit performances with paths and poses, loop or stitch clips, measure motion metadata, and run the bundled Three.js game reference.

Watch the Blender demo · Production setup walkthrough · MCP Blender workflow · More Blender examples

Three generated characters, one Blender scene

Lantern Port takes three text descriptions through character generation and auto-rigging, combines Comic 4 acting with swing-edit walking, then renders a miniature skyport with four camera shots and a frog close-up. The example includes the three rigged assets, exact prompts, reproducible Blender scripts, and the reviewed shoulder, face and Gaussian foot-contact fixes.

Watch Lantern Port · Rebuild the scene · Create and auto-rig characters

What you need

  • Node.js 22 or newer and Git.
  • A Cartwheel production account with API access and a project API key. API access is available on Individual Basic, Individual Pro, Team Standard, Team Pro, and Team Scale. Check the current plans for credit and batch/concurrency limits.
  • An MCP client that can launch local stdio servers. This repository runs on your machine; it is not a hosted MCP URL.
  • Blender only if you want to render the examples. The MCP server itself does not require Blender.

1. Get a Cartwheel API key

  1. Open Cartwheel, choose an API-enabled plan (Individual Basic, Individual Pro, Team Standard, Team Pro, or Team Scale), and create your account. Complete email verification and any plan setup shown by the site.
  2. Open your Cartwheel dashboard and select API keys.
  3. Create or reveal a key for your workspace/project. Key management may require a workspace administrator.
  4. Copy the secret key value. The project ID and API Gateway key ID are not substitutes.

The setup guide includes a recording of the actual production signup interface and the steps that follow.

2. Install

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "cartwheel": { "command": "node", "args": ["/absolute/path/to/cartwheel-mcp/src/index.mjs"], "env": { "CARTWHEEL_API_KEY": "YOUR_CARTWHEEL_PROJECT_API_KEY" } } } }