dcc-mcp-substancedesigner

Substance Designer adapter for the DCC Model Context Protocol (MCP) ecosystem.

This repository provides a Python MCP adapter and a maintained Adobe Substance 3D Designer host plugin. It uses dcc-mcp-core for shared MCP server contracts, skill loading, and gateway integration, while Substance Designer-specific bridge behavior, graph tooling, and plugin commands are owned here.

Features

• Repository-owned Substance Designer plugin under plugin/
• Local length-prefixed JSON TCP bridge on 127.0.0.1:9881
• MCP backend endpoint on 127.0.0.1:8766/mcp
• Gateway endpoint on 127.0.0.1:9765/mcp
• Bundled skills for scene inspection, graph authoring, and reference lookup
• Fake-host tests for normal CI without a running Substance Designer instance
• Opt-in live integration and mutation tests for a real host session
• Local stub generator for editor assistance without redistributing Adobe or PySide API stubs

Status

This project is an early 0.1.x adapter. Normal CI uses fake-host tests and does not require Substance Designer. Live host checks are opt-in and require Substance 3D Designer 16.0+ with this repository’s plugin loaded. Mutation tests are gated separately because they intentionally edit the connected host session.

Installation

GitHub Releases are the distribution channel. Normal users should download the single Windows bundle:

dcc-mcp-substancedesigner--windows.zip

The bundle assumes Windows, Substance Designer 16.0+, and uv. It contains the Python wheel, the Substance Designer plugin folder, install.bat, README.txt, and local installation notes. Wheel, sdist, and standalone plugin ZIP artifacts are built as internal packaging inputs, but the GitHub Release should expose only the Windows bundle.

For user installation steps, see docs/install.md. For source checkout workflows, see docs/development.md. For LLM agent setup notes, see docs/install-agent.md.

MCP clients should connect to the gateway endpoint:

http://127.0.0.1:9765/mcp

Usage

The default endpoints are:

• Gateway MCP for clients: http://127.0.0.1:9765/mcp
• Backend MCP for direct diagnostics: http://127.0.0.1:8766/mcp
• Substance Designer plugin bridge: 127.0.0.1:9881

Check bridge readiness directly: