使用说明
mixamo-mcp
基于剧作家的自动化工具 米克萨莫,同时具有用于Claude Code集成的CLI操作员和MCP服务器。
特性
- 浏览和搜索动画
- 通过Auto Rigger上传自定义字符(FBX/OBJ/ZIP)
- 设置动画参数(原地、镜像、超速、手臂空间、修剪)
- 下载带有您角色的动画(适用于Unity/虚幻、Collada的FBX)
- 持久浏览器会话——登录一次,保持登录状态
- MCP服务器,因此Claude Code可以作为工具驱动一切
设置
pip install -r requirements.txt
playwright install chromium
CLI使用情况
python main.py
可用命令:
| 命令 | 描述 |
|---|---|
list [query] |
列出动画,可选择按查询过滤 |
select <id> |
按ID选择动画 |
set inplace true/false |
切换到位模式 |
set mirror true/false |
切换镜子 |
set overdrive <0-100> |
设置超速档滑块 |
upload <path> |
上传字符文件 |
download <path> |
下载当前动画 |
status |
显示当前屏幕和动画信息 |
quit |
退出 |
MCP服务器(克劳德代码)
MCP服务器允许Claude Code作为工具直接控制Mixamo。
配置
添加到您的 .mcp.json (已包含在此回购中):
{
"mcpServers": {
"mixamo": {
"command": "python",
"args": ["C:\\Users\\vital\\Projects\\mixamo-mcp\\mcp_server.py"]
}
}
}
可用工具
| 工具 | 说明 |
|---|---|
status() |
当前屏幕、角色、动画、参数 |
list_animations(query) |
搜索动画 |
select_animation(id) |
按ID选择动画 |
set_param(name, value) |
设置到位/后视镜/超速档/手臂空间/装饰 |
upload_character(path) |
将角色上传到Auto Rigger |
download_animation(path, format, skin, fps) |
下载动画 |
confirm_review() |
确认汽车装配工审查步骤 |
close_upload_modal() |
关闭上传模式 |
下载格式
| 密钥 | 格式 |
|---|---|
fbx_unity |
Unity的FBX(默认) |
fbx |
FBX 2019 |
fbx_ascii |
FBX 2019 ASCII |
fbx_7.4 |
FBX 2014 |
fbx_6.1 |
FBX 6.1 |
collada |
Collada(.科) |
备注
- 不运行
main.py和mcp_server.py同时,两者都使用相同的浏览器配置文件 - 通过可见浏览器登录一次;会话保存在
browser_profile/