内容
# HocusPocus
HocusPocus 是一个Houdini 21.x的MCP服务器，运行在Houdini内部，并与应用程序自动启动。它旨在实现一次安装、连接代理的工作流程。
## 安装
从仓库根目录：
```powershell
powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1 -Clean -Install
```
该命令将软件包安装到：
```text
%USERPROFILE%\Documents\houdini21.0\packages\
```
## 验证
启动Houdini。在Houdini的Python shell中：
```python
import hocuspocus
print(hocuspocus.server_status())
```
预期输出：
- `running: True`
- `serverVersion: 0.9.0`
- `mcpUrl: http://127.0.0.1:37219/hocuspocus/mcp`
## 连接 Codex（Windows）
在 Codex 应用程序中添加自定义MCP服务器：
- 传输方式：`Streamable HTTP`
- 名称：`houdini`
- URL：`http://127.0.0.1:37219/hocuspocus/mcp`
使用来自以下位置的 bearer token：
```text
%USERPROFILE%\Documents\houdini21.0\hocuspocus\runtime\token.txt
```
如果应用程序要求使用标头而不是令牌字段：
```text
Authorization: Bearer <your-token>
```
健康检查路由是：
```text
http://127.0.0.1:37219/hocuspocus/healthz
```
## 功能
当前服务器功能包括：
- 实时场景、节点、参数、选择、播放条、相机和视口工具
- 动态节点和任务资源
- 非阻塞烹饪、渲染和导出任务，支持轮询和取消
- 材料创建和分配工具
- 高级工具，如批量图编辑、转盘相机创建、托管快照、几何摘要和房屋封锁宏
- 命名策略配置文件，支持有效策略状态和资源报告
## 文档
有关完整的用户手册，请参阅 [HocusPocus 手册](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\docs\user-manual.md)。
有关兼容性和发布规则，请参阅 [兼容性策略](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\docs\compatibility-policy.md) 和 [发布验证](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\docs\release-validation.md)。
有关代理工作流模式，请参阅 [代理工作流](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\docs\agent-workflows.md)。
有关工程状态，请参阅 [改进跟踪器](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\docs\improvement-task-tracker.md)。
## 许可证
MIT。参见 [LICENSE](C:\Users\jujun\Documents\Source\Houdini\HocusPocus_mcp\LICENSE)。
