Metadata-Version: 2.4
Name: dcc-mcp-substance3d-designer
Version: 0.1.0
Summary: Substance 3D Designer adapter for the DCC Model Context Protocol ecosystem
Project-URL: Homepage, https://github.com/dcc-mcp/dcc-mcp-substance3d-designer
Project-URL: Repository, https://github.com/dcc-mcp/dcc-mcp-substance3d-designer
Project-URL: Issues, https://github.com/dcc-mcp/dcc-mcp-substance3d-designer/issues
Project-URL: Changelog, https://github.com/dcc-mcp/dcc-mcp-substance3d-designer/releases
Author-email: Long Hao <hal.long@outlook.com>
License: MIT
License-File: LICENSE
Keywords: ai,dcc,mcp,model-context-protocol,substance,substance-3d-designer
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Requires-Python: >=3.9
Requires-Dist: dcc-mcp-core<1.0.0,>=0.19.3
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: pyyaml>=6.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# dcc-mcp-substance3d-designer

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

The package runs an embedded Streamable HTTP MCP server inside Designer, so
tools execute through Designer's Qt main thread instead of a separate process.

## Install and load

Install this package with the Python environment used by Substance 3D Designer:

```bash
python -m pip install dcc-mcp-substance3d-designer
```

In Designer, open **Tools > Plugin Manager**, browse to the installed
`dcc_mcp_substance3d_designer/designer_plugin.py`, then load the plugin. The
MCP endpoint defaults to `http://127.0.0.1:8765/mcp`.

Set `DCC_MCP_SUBSTANCE3D_DESIGNER_PORT` before launching Designer to choose a
different port. Standard `DCC_MCP_GATEWAY_PORT` and `DCC_MCP_REGISTRY_DIR`
settings are also honoured.

## Bundled skills

`designer-session` provides read-only typed tools for inspecting the active
Designer session and its loaded packages. Host APIs are imported only while a
tool runs, so metadata discovery remains safe outside Designer.

## Development

```bash
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.
