内容
# vfx-agent-toolkit
用于VFX制作的Claude Code插件和MCP连接器。一个克隆即可获得适用于Nuke、Houdini、Unreal Engine、Blender、ComfyUI、Maya、Magnific和Seedance的技能、代理和应用程序桥接。
由一位从事日常VFX制作的艺术家构建。开源，以便您可以使用、修改和改进。采用MIT许可证。
## 这是什么？
一个仓库包含两部分：
- **插件** (`plugins\`) 教会Claude Code如何进行VFX工作。每个插件都是一 bundle技能（生产测试的知识，按需加载）和代理（委托任务的专用处理程序）。
- **连接器** (`connectors\`) 通过MCP（模型上下文协议）将Claude Code连接到正在运行的应用程序，以便Claude可以在Nuke中创建节点、驱动Houdini、控制Unreal等。
技能告诉Claude **怎么做**；连接器给予它 **执行能力**。
## 快速入门
1. 在Claude Code中添加市场：
```bash
/plugin marketplace add sideshowroberto/vfx-agent-toolkit
```
2. 首先安装基础插件，然后安装所需的应用程序插件：
```bash
/plugin install vfx-core@vfx-agent-toolkit
/plugin install nuke-vfx@vfx-agent-toolkit
```
3. 运行核心设置脚本一次，以注册共享MCP服务器（brave-search、context7、desktop-commander），并可选地复制工作区模板：
```powershell
plugins\vfx-core\install.ps1
```
brave-search 需要从 https://brave.com/search/api 获取免费的API密钥。context7 和 desktop-commander 不需要任何操作。
4. 对于与正在运行的应用程序（Nuke、Houdini、Unreal、Blender、Maya、ComfyUI）交互的插件，克隆此仓库并运行匹配的连接器安装程序：
```powershell
git clone https://github.com/sideshowroberto/vfx-agent-toolkit.git
cd vfx-agent-toolkit
connectors\nuke\install.ps1
```
5. 重启Claude Code。MCP服务器在启动时加载，因此任何配置更改都需要重启。
安装程序是PowerShell，因此设置主要针对Windows。技能和代理本身是纯Markdown，在任何Claude Code运行的地方都有效。
完整的操作指南和预期输出：[docs/GETTING-STARTED.md](docs/GETTING-STARTED.md)
## 插件
首先安装 `vfx-core`。其他插件按需安装，根据项目需求。
| 插件 | 功能 |
|--------|----------------|
| `vfx-core` | 基础包 - 首先安装。跨应用程序的技能和代理：搜索、文档、测试、Python、规划、技能/代理创建、git安全防护和会话总结。注册核心MCP服务器（brave-search、context7、desktop-commander）。 |
| `nuke-vfx` | Nuke合成管道：节点图、BlinkScript、Cattery AI推理、Python脚本、平铺工具、批量镜头设置和Magnific-in-Nuke。 |
| `houdini-vfx` | Houdini VFX管道：程序生成、USD/Solaris、VEX、Python自动化、HDA创建。 |
| `unreal-vfx` | Unreal Engine 5.8 VFX管道，通过原生UE MCP（ModelContextProtocol插件 + VibeUE工具集）：蓝图自动化、PCG、演员操作、Sequencer、Python脚本。 |
| `blender-vfx` | Blender VFX管道，通过官方Blender MCP（blender.org）：建模、动画、材质、几何节点、物理、渲染、雕塑、油漆笔和ControlNet渲染，用于AI生成。 |
| `comfyui-vfx` | ComfyUI管道，通过ComfyUI MCP和Comfy CLI：工作流分析、节点/模型需求映射和无头生成指导。 |
| `comfyui-node-dev` | ComfyUI自定义节点开发：V3 API节点结构、模式、数据类型、输入/输出、执行生命周期、前端扩展、V1到V3迁移和打包/发布。 |
| `maya-vfx` | Maya管道，通过MCP：场景控制、几何创建、材质（Arnold/USD）、变换和FBX导入/导出。 |
| `magnific-vfx` | Magnific AI生成，通过MCP：图像生成，模型选择和参考，本地文件上传/下载管道和视频生成。 |
| `seedance-vfx` | Seedance 2.0视频生成方向：提示编写、相机、灯光、运动、角色、风格、VFX、故障排除和生产配方。 |
## 连接器
连接器注册MCP服务器，连接Claude Code到您的应用程序。详细信息和应用程序特定说明：[connectors/README.md](connectors/README.md)
| 连接器 | 功能 | 备注 |
|-----------|--------------|-------|
| `connectors\nuke` | 将捆绑的桥接文件安装到 `~\.nuke` 并注册Nuke MCP | 桥接代码包含在此仓库中 |
| `connectors\houdini` | 安装Houdini桥接器并注册Houdini MCP | 桥接代码包含在此仓库中 |
| `connectors\unreal` | 注册UE 5.8原生MCP（ModelContextProtocol插件，HTTP端口8000） | UE 5.8启用插件；推荐使用Fab的VibeUE |
| `connectors\maya` | 安装Maya桥接器并注册Maya MCP | 桥接代码包含在此仓库中 |
| `connectors\blender` | 注册官方Blender MCP（blender.org） | 插件随Blender 4.5+发布；仅需register.ps1 |
| `connectors\comfyui` | 注册ComfyUI MCP（`npx comfyui-mcp`） | 推荐使用Comfy CLI（`pip install comfy-cli`）进行无头生成 |
| `connectors\magnific` | 注册托管的Magnific MCP（https://mcp.magnific.com） | 需要Magnific账户；首次使用时在浏览器中进行OAuth |
## 需求
| 需求 | 需要用于 |
|-------------|-----------|
| [Claude Code](https://claude.com/claude-code) | 所有功能 |
| Node.js 18+ | Nuke MCP服务器，基于npx的连接器 |
| Python 3.12+ | 桥接脚本，ComfyUI工具 |
| [uv](https://docs.astral.sh/uv/) | 基于Python的MCP服务器（Houdini，Blender） |
| Windows + PowerShell | 安装程序（技能/代理可在任何操作系统上运行） |
每个应用程序：Nuke 14+，Houdini 20+，Unreal Engine 5.8，Blender 4.5+（捆绑MCP插件），Maya 2024+，本地ComfyUI安装，以及用于Magnific连接器的Magnific账户。
## 仓库布局
```
vfx-agent-toolkit\
+-- .claude-plugin\
| +-- marketplace.json 市场清单（/plugin读取）
+-- plugins\
| +-- vfx-core\ 基础：技能、代理、install.ps1、模板
| +-- nuke-vfx\ 应用程序特定插件：技能\ + 代理\ + plugin.json
| +-- houdini-vfx\
| +-- unreal-vfx\
| +-- blender-vfx\
| +-- comfyui-vfx\
| +-- comfyui-node-dev\
| +-- maya-vfx\
| +-- magnific-vfx\
| +-- seedance-vfx\
+-- connectors\
| +-- nuke\ install.ps1 + register.ps1 + bridge\
| +-- houdini\
| +-- unreal\
| +-- maya\
| +-- blender\ register.ps1仅（官方Blender MCP）
| +-- comfyui\
| +-- magnific\
+-- docs\
| +-- GETTING-STARTED.md
| +-- ARCHITECTURE.md
+-- LICENSE
```
## 致谢和出处
该工具包是一个工作集合：大部分技能、代理和脚本是原创作品，在生产环境中构建和测试。少数是从开源工具、社区资源和我们发现的有用的提示改编而来 - 有些直接使用，有些则经过大量修改。该集合在工作流程中逐渐增长，因此每个部分的准确来源并未始终跟踪。
对于从他人那里获取的内容，不声明原创作者权。如果您在此认出了您的作品，并希望添加署名、注明许可证或删除内容，请打开一个问题 - 我们将及时、乐意地处理。
连接器注册的MCP服务器是独立项目，由其各自的作者开发，不属于该工具包：
| 服务器 | 作者 / 来源 |
|--------|-----------------|
| Blender MCP | 官方Blender MCP（blender.org，随Blender 4.5+发布） |
| UE 5.8 ModelContextProtocol | Epic Games（内置于Unreal Engine 5.8） |
| VibeUE | VibeUE（Fab市场） |
| comfyui-mcp | 其作者的npm包 |
| ComfyUI_FL-MCP | filliptm（github.com/filliptm/ComfyUI_FL-MCP） |
| Comfy CLI | Comfy Org |
| Magnific MCP | 由Magnific托管（mcp.magnific.com） |
第三方工具保留其自身的许可证；此仓库中的MIT许可证涵盖工具包本身的原始内容。
## 贡献
欢迎PR。技能遵循标准的Claude Code SKILL.md格式：一个`skills\<skill-name>\SKILL.md`文件，包含`name`和`description` YAML前置信息。保持所有内容仅限ASCII字符，不包含个人或特定于工作室的路径。参见 [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) 了解插件格式和PR检查清单。
## 许可证
MIT。参见 [LICENSE](LICENSE)。
