CLO3D MCP服务器
从Claude、Cursor或任何MCP客户端与CLO3D对话。创建图案、交换织物、运行模拟、导出模型。全部来自聊天窗口。
如果您使用CLO3D，并且希望可以编写重复任务的脚本，而无需挖掘API文档，那么这就是您的选择。
Your AI assistant MCP Server CLO3D Plugin CLO3D快速开始
1.在CLO3D中加载插件
一个Python文件，没有依赖关系。
- 打开CLO3D
- 脚本>脚本编辑器
- 打开
plugin/clo3d_mcp_plugin.py - 击打 跑
你会看到 [CLO MCP] Plugin started 在控制台中。
2.连接您的AI客户端
克劳德代码：
claude mcp add clo3d -- uvx clo3d-mcp克劳德桌面版 （添加到 claude_desktop_config.json):
{
"mcpServers": {
"clo3d": {
"command": "uvx",
"args": ["clo3d-mcp"]
}
}
}3.去吧
问这样的问题：
- *“这个项目有什么模式？”*
- *“将前胸衣面料设置为红色”*
- *“运行100步模拟，然后导出为GLB”*
- *“导出所有颜色的转盘”*
你得到了什么（33个工具）
场景
| 工具 | 它做什么 |
|---|---|
get_project_info | 项目名称、文件路径、CLO版本、件数 |
new_project | 重新开始 |
open_file | 打开.zprj、.zpac、.obj、.fbx、.avt |
save_project | 另存为.zprj |
get_garment_info | 将完整的服装元数据转储为JSON |
模式
| 工具 | 它做什么 |
|---|---|
get_pattern_count | 有多少件 |
get_pattern_list | 所有带有名称和索引的作品 |
get_pattern_info | 一体式细节设计 |
get_pattern_bounding_box | 宽度和高度 |
set_pattern_name | 重命名一个片段 |
copy_pattern | 在给定位置复制 |
delete_pattern | 移除一块 |
flip_pattern | 水平或垂直翻转 |
create_pattern | 从顶点构建新工件 |
get_arrangement_list | 获取头像排列点数 |
织物
| 工具 | 它做什么 |
|---|---|
get_fabric_list | 所有带索引的织物 |
add_fabric | 加载.zfab或.jfab |
replace_fabric | 交换现有结构 |
assign_fabric_to_pattern | 在图案片上放一块布料 |
set_fabric_color | 设置PBR基色（RGB） |
get_fabric_for_pattern | 检查一件衣服上有什么布料 |
出口
| 工具 | 它做什么 |
|---|---|
export_obj | OBJ选项 |
export_fbx | FBX |
export_glb | GLB（二进制glTF） |
export_gltf | glTF |
export_thumbnail | 3D视口截图 |
export_snapshot | 多视图快照 |
export_turntable | 360转盘图像序列 |
export_tech_pack | 包含JSON+图像的技术包 |
导入
| 工具 | 它做什么 |
|---|---|
import_file | 自动检测并导入任何支持的格式 |
模拟
| 工具 | 它做什么 |
|---|---|
simulate | 运行布料模拟N步 |
配色方案
| 工具 | 它做什么 |
|---|---|
get_colorways | 列出所有配色方案 |
set_current_colorway | 切换活动配色 |
运作原理
两件：
插件 (plugin/clo3d_mcp_plugin.py)在CLO3D内部运行。它是一个单独的Python文件，用于轮询JSON命令的共享临时目录，调用CLO3DPython API，并写回结果。没有外部依赖，没有套接字，与CLO3D的内置Python兼容。
MCP服务器 (src/clo3d_mcp/)是一个Python包，它将命令写入该目录并读取响应。任何兼容MCP的客户端（Claude、Cursor等）都可以使用它。
┌─────────────────┐ file-based IPC ┌──────────────────┐ CLO3D API ┌────────┐
│ MCP Server │ ◄──────────────► │ CLO3D Plugin │ ◄──────────────► │ CLO3D │
│ (clo3d-mcp) │ %TEMP%/clo3d_mcp │ (Python script) │ │ │
└─────────────────┘ └──────────────────┘ └────────┘故障排除
“找不到CLO3D通信目录”CLO3D正在运行吗？你运行了插件脚本吗？
插件错误：检查CLO3D中的脚本编辑器控制台以获取Python回溯。
模拟/导出超时：这些可能需要一段时间。默认超时为180秒。
自定义通信目录：设置 CLO3D_MCP_DIR 环境变量来覆盖默认的共享目录路径。
需求
- 支持Python脚本的CLO3D
- Python 3.10+
- 紫外线或pip
发展
git clone https://github.com/Ubani-Studio/clo3d-mcp.git
cd clo3d-mcp
# Install dev dependencies
uv sync --dev
# Run tests (no CLO3D needed, uses a mock server)
uv run pytest tests/ -v
# Run the MCP server locally
uv run clo3d-mcp许可证
MIT。看 许可证.
CLO3D SDK头文件 sdk/ 由CLO Virtual Fashion提供，用于插件开发。您需要自己的CLO3D许可证。