内容
# mcp-server-vred
Autodesk VRED 的 MCP 服务器 — 通过 [模型上下文协议](https://modelcontextprotocol.io/) 控制场景、材质、渲染、动画和变体。
## 功能
- **场景管理** — 打开、保存、列出对象、获取层次结构、获取场景信息、显示/隐藏对象
- **材质** — 列出、创建、应用、获取属性、更改颜色和粗糙度
- **渲染** — 截图、质量设置、分辨率、相机控制
- **动画** — 播放、暂停、停止、查找、播放全部、停止全部
- **变体** — 列出变体集、激活变体和组合
- **Python 执行** — 在 VRED 的解释器中运行任意 Python 代码
- **状态** — 检查与 VRED 的连接并报告其版本
## 要求
- **VRED** 且启用 Web 服务器（Preferences > Web 接口 > 启用 Web 服务器）
- **Python** >= 3.10
- **mcp** SDK (`mcp[cli]` >= 1.0.0)
## 安装
```bash
pip install -e .
```
## 配置
设置环境变量（可选，显示默认值）：
| 变量 | 默认值 | 描述 |
| -------------- | ----------- | ---------------------- |
| `VRED_HOST` | `localhost` | VRED Web 接口主机 |
| `VRED_PORT` | `8888` | VRED Web 接口端口 |
| `VRED_PROTOCOL`| `http` | 协议（http 或 https） |
## 在 VS Code 中使用
添加到 `.vscode/mcp.json`：
```json
{
"servers": {
"vred": {
"command": "mcp-server-vred",
"env": {
"VRED_HOST": "localhost",
"VRED_PORT": "8888"
}
}
}
}
```
## VRED 设置
1. 打开 VRED
2. 转到 **Preferences > Web 接口**
3. 勾选 **启用 Web 服务器**（默认端口 8888）
4. 确保 **安全 Python** 未勾选，以便服务器可以通过 `/pythonapi` 端点执行 Python
## 许可证
私有 — 保留所有权利。
