dcc-mcp-substance3d-painter 0.1.1

Substance 3D Painter adapter for the DCC Model Context Protocol ecosystem

dcc-mcp-substance3d-painter

Substance 3D Painter adapter for the DCC Model Context Protocol (MCP).

It embeds a Streamable HTTP MCP server in Painter and routes host API calls through Painter's Qt main thread. The default endpoint is http://127.0.0.1:8765/mcp.

Install and load

Install into the Python environment Painter uses:

python -m pip install dcc-mcp-substance3d-painter

Point SUBSTANCE_PAINTER_PLUGINS_PATH at the installed package's dcc_mcp_substance3d_painter/painter folder. Painter discovers the packaged plugins/dcc_mcp_substance3d_painter.py; enable it from the Python menu.

Set DCC_MCP_SUBSTANCE3D_PAINTER_PORT before launching Painter to choose a different port. Standard DCC_MCP_GATEWAY_PORT and DCC_MCP_REGISTRY_DIR settings are also honoured.

Bundled skills

painter-project inspects the current project and texture sets. Its typed export tool exports texture sets using a caller-provided Painter export preset URL, avoiding raw JavaScript or arbitrary script execution.

Development

python -m pip install -e ".[dev]"
python -m pytest
ruff check src tests tools
python -m build

Releases use release-please. The release.yml workflow publishes through the pypi environment using PyPI Trusted Publishing.