dcc-mcp-mari

Production-oriented DCC-MCP adapter for Foundry Mari. It exposes project, geometry, channel, node graph, layer, shader, image, and texture-export workflows as typed tools without arbitrary Python execution. The host plugin supports Mari 5.0 and newer while keeping the DCC-MCP runtime in a separately installed Python 3.9+ sidecar.

Architecture

Mari loads a small standard-library plugin on its GUI thread. The plugin owns an authenticated loopback socket and starts the separately installed DCC-MCP sidecar. A Qt timer executes bounded Mari API commands on the host thread, while networking, discovery, jobs, and Gateway integration stay outside Mari's bundled Python environment.

Install

The authoritative agent-first lifecycle, platform paths, stable JSON schema, exit codes, recovery behavior, and troubleshooting are in install.md.

python -m pip install dcc-mcp-mari
dcc-mcp-mari install --dcc-path <mari-executable> --python <python> --dry-run --json
dcc-mcp-mari install --dcc-path <mari-executable> --python <python> --yes --json

Restart Mari after installation. The default Windows target is Documents/Mari/Scripts. Override it for a custom MARI_SCRIPT_PATH:

dcc-mcp-mari install --dcc-path <mari-executable> --python <python> --script-dir "D:/Mari/Scripts" --yes --json

Uninstall only this adapter's startup files:

dcc-mcp-mari uninstall --dcc-path <mari-executable> --python <python> --yes --json

Capability groups

• mari-session: connection and full project lifecycle, including archive, rename, duplicate, and removal.
• mari-geometry: geometry and channel lifecycle.
• mari-nodegraph: nodes, connections, and layer stacks.
• mari-lookdev: shaders, images, export items, and texture export.

All host mutations require a live Mari process. File inputs must be existing absolute paths, output parents must already exist, and destructive operations are explicitly annotated for DCC-MCP clients.

Development

python -m pip install -e ".[dev]"
python -m ruff check src tests
python -m ruff format --check src tests
python -m pytest
python -m build
python -m twine check dist/*

Mari Python API reference: Using Python in Mari.