Content
# mcp-server-vred
MCP Server for Autodesk VRED — Control scenes, materials, rendering, animations & variants via the [Model Context Protocol](https://modelcontextprotocol.io/).
## Features
- **Scene Management** — Open, save, list objects, get hierarchy, get scene info, show/hide objects
- **Materials** — List, create, apply, get properties, change color and roughness
- **Rendering** — Screenshots, quality settings, resolution, camera control
- **Animations** — Play, pause, stop, seek, play all, stop all
- **Variants** — List variant sets, activate variants and combinations
- **Python Execution** — Run arbitrary Python code in VRED's interpreter
- **Status** — Check connection to VRED and report its version
## Requirements
- **VRED** with Web Server enabled (Preferences > Web Interface > Enable Web Server)
- **Python** >= 3.10
- **mcp** SDK (`mcp[cli]` >= 1.0.0)
## Installation
```bash
pip install -e .
```
## Configuration
Set environment variables (optional, defaults shown):
| Variable | Default | Description |
| --------------- | ----------- | ------------------------ |
| `VRED_HOST` | `localhost` | VRED Web Interface host |
| `VRED_PORT` | `8888` | VRED Web Interface port |
| `VRED_PROTOCOL` | `http` | Protocol (http or https) |
## Usage with VS Code
Add to `.vscode/mcp.json`:
```json
{
"servers": {
"vred": {
"command": "mcp-server-vred",
"env": {
"VRED_HOST": "localhost",
"VRED_PORT": "8888"
}
}
}
}
```
## VRED Setup
1. Open VRED
2. Go to **Preferences > Web Interface**
3. Check **Enable Web Server** (default port 8888)
4. Ensure **Secure Python** is unchecked so the server can execute Python via the `/pythonapi` endpoint
## License
Private — All rights reserved.