从单张角色图像生成模拟的中间 Live2D 包。
用于图像分析、面部提取、图层生成、绑定、物理、动作和导出的 MCP 工具
服务器签发的会话 ID，具有 TTL、并发限制、显式关闭支持和状态指标
输出目录限制在 output/ 下
在报告成功之前验证模拟的 .moc3 导出契约
分析步骤上具有显式的 detector_used、fallback_reason 和 confidence_summary 元数据
Related MCP server: VRMCP
最小运行时：
pip install -e .CPU 辅助视觉栈：
pip install -e ".[vision-cpu]"GPU 辅助视觉栈：
pip install -e ".[vision-gpu]"开发工具：
pip install -e ".[dev]"python -m mcp_server.serverlive2d-run run --image-path ATRI.png --output-dir output/ATRI --demo-adapter-mode full或者不使用控制台脚本：
python -m mcp_server.cli run --image-path ATRI.png --output-dir output/ATRI --demo-adapter-mode fullCLI 会将 <model_name>_cli_report.json 文件写入输出目录。
如果您已经拥有支持 Cubism 的 PSD，并且只想调整 Cubism 自动化部分，请使用校准命令而不是重新运行图像分析：
python -m mcp_server.cli calibrate-template --output-dir output/ATRI_real --model-name ATRI --psd-path output/ATRI_real/ATRI.psd --editor-path "C:\Program Files\Live2D\Cubism5\Cubism Editor 5\CubismEditor5.exe" --native-gui-controller-mode execute如果省略 --psd-path，CLI 将查找 <output_dir>/<model_name>.psd。这是校准 template_menu_sequence 最快的循环，因为它只会重建 Cubism 计划、分发包、执行报告和配置文件校准报告。
当您想在同一个输出目录中从最新的兼容分发执行继续时，请添加 --resume。CLI 仅在 PSD 文件、模板 ID、编辑器路径和控制器模式仍然匹配时才会恢复；否则它将回退到全新执行并将该决定记录在 CLI 报告中。
from mcp_server.server import full_pipeline
result = await full_pipeline(
image_path="ATRI.png",
output_dir="output/ATRI",
model_name="ATRI",
motion_types=["idle", "tap", "move", "emotional"],
)调用 analyze_photo(image_path) 并存储返回的 session_id
调用 detect_face_features(session_id, output_dir)
调用 generate_layers(session_id, output_dir)
调用 create_mesh(session_id)
调用 setup_rigging(session_id)
调用 configure_physics(session_id)
调用 generate_motions(session_id, motion_types)
调用 export_model(session_id, output_dir, model_name)
当步骤流程完成时，调用 close_session(session_id)
output_dir 必须保留在项目 output/ 目录内
对于测试和受控的本地运行，LIVE2D_OUTPUT_ROOT 可以指向项目内的另一个目录；MCP 和 CLI 入口点将解析该根目录下的 output_dir
model_name 仅支持字母、数字、_ 和 -
输入图像格式：png, jpg, jpeg, webp
输入图像限制：20 MiB，4096x4096，总像素 16,777,216
支持的动作类型：idle, tap, move, emotional
远程语义部件检测是隐私选择加入的。当 LIVE2D_PART_BACKEND=api 时，在将图像字节发送到 LIVE2D_PART_API_URL 之前，请设置 LIVE2D_PART_API_ALLOW_UPLOAD=1。对于锁定环境，请使用 LIVE2D_PART_API_ALLOWED_HOSTS 作为逗号分隔的主机允许列表。
最小的 Cubism 执行 PoC 可以通过 LIVE2D_NATIVE_GUI_ADAPTER_COMMAND 调用外部原生 GUI 适配器。适配器契约记录在 docs/native_gui_adapter_contract.md 中。
简而言之：
MCP 附加一个动作名称，例如 launch_editor、import_psd、apply_template 或 export_embedded_data
退出代码 0 表示成功
退出代码 64 表示“不支持，请回退”以进行后续的 PoC 步骤
其他非零代码被视为执行失败
您可以使用捆绑的演示适配器测试 PoC：
set LIVE2D_NATIVE_GUI_ADAPTER_COMMAND=python scripts/native_gui_adapter_demo.py --mode partial使用 --mode full 让演示适配器发出最小的模拟导出包，或使用 --mode fail 模拟硬适配器故障。
您还可以为前两个步骤启用内置的 Windows GUI 控制器：
live2d-run run --image-path ATRI.png --output-dir output/ATRI --editor-path "C:\Program Files\Live2D\Cubism5\Cubism Editor 5\CubismEditor5.exe" --native-gui-controller-mode dry_rundry_run 为 launch_editor / import_psd 编写 PowerShell 脚本和收据；execute 将尝试使用捆绑的配置文件在 Windows 上运行这些脚本。
捆绑的 Windows 配置文件现在包含用于重试期间常见对话框恢复的保守种子规则：
import_psd：尝试 Open 和 Import PSD
apply_template：尝试 Template 和 Confirm
export_embedded_data：尝试 Export 和 Overwrite
每个恢复工件还记录一个 dialog_recovery_plan 部分，以便您可以查看选择了哪些特定于操作或默认的恢复规则。这些种子旨在在生产使用前针对您的本地 Cubism 窗口标题进行调整。
内置探测器现在还记录匹配的窗口标题和轻量级诊断信息。当真实的 Cubism 运行表现不如预期时，请先检查探测器 JSON，查看控制器实际可见的窗口标题。
每个分发执行现在还会写入一个 {model_name}_cubism_profile_calibration*.json 报告，总结了：
观察到的探测器窗口标题
缺失的 window_probe_candidates
每个操作的对话框恢复观察结果
建议的 known_dialog_recovery 添加内容
在针对真实的 Cubism 安装调整内置 Windows 配置文件时，请将此报告作为主要指南。
对于 apply_template，内置控制器现在需要显式的配置文件驱动调用。捆绑的默认配置文件特意将其留空，因为 Cubism 的模板工作流依赖于 UI 版本，错误的快捷键比没有快捷键更糟糕。
使用 mcp_server/profiles/windows_cubism_default.json 中的 template_menu_sequence 来定义菜单驱动的动作序列，例如：
"template_menu_sequence": [
{ "keys": "%m", "wait_seconds": 0.2 },
{ "keys": "t", "wait_seconds": 0.2 },
{ "keys": "a", "wait_seconds": 0.2 }
]根据官方编辑器手册中记录的 Cubism 菜单路径校准该序列： [Modeling] -> [Model template] -> Apply template。
如果 apply_template 在没有工件的情况下失败，校准报告现在将明确告诉您 template_menu_sequence 或 template_shortcut 是否仍然缺失，并将在诊断中重复该推荐的菜单路径。
对于 export_embedded_data，当快捷键路径不可靠时，内置控制器也可以通过菜单驱动的序列进行校准。使用 mcp_server/profiles/windows_cubism_default.json 中的 export_menu_sequence 来实现如下序列：
"export_menu_sequence": [
{ "keys": "%f", "wait_seconds": 0.2 },
{ "keys": "e", "wait_seconds": 0.2 },
{ "keys": "m", "wait_seconds": 0.2 }
]根据官方编辑器手册中记录的 Cubism 菜单路径校准该序列： [File] -> [Export Embedded File] -> Export as MOC3 file。
如果 export_embedded_data 在没有打开对话框的情况下失败，校准报告现在将明确告诉您 export_menu_sequence 或 export_shortcut 是否仍然缺失，并将在诊断中重复该推荐的菜单路径。
导出器写入的是模拟的中间包，而不是生产就绪的 Live2D 运行时模型
model3.json 和返回的文件清单始终引用 {model_name}.moc3
在存在真正的 Cubism 兼容导出器之前，ready_for_cubism_editor 保持为 false
最终验证和导出应在生产使用前在 Cubism Editor 中进行
MIT
This server cannot be deployed
Generate your app's mascot, then props, poses and animations that stay on-model.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Create AI animations and export transparent sprite sheets, alpha video, frames, and game assets.
Generate AI influencer photos, face swaps, and character sheets with a consistent face.
