Mixamo自动化工具

一个基于Playwright的Mixamo自动化工具,提供CLI操作和MCP服务器功能,用于浏览、搜索动画,上传自定义角色并下载动画。

  • by V1xel
  • Python
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 V1xel/mixamo-mcp

使用说明

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/