DCC Model Context Protocol (MCP) 생태계에 대한 인스턴스 디자이너 어댑터.

이 저장소는 Python MCP 어댑터와 Adobe Substance 유지를 제공합니다. 3D 디자이너 호스트 플러그인. 그것은 사용 dcc-mcp-core] MCP 서버 공유 계약, 기술 로딩 및 게이트웨이 통합, 물질 Designer-specific bridge behavior, graph tooling 및 플러그인 명령은 소유 이름 *

특징

• Repository-owned Substance Designer 플러그인 plugin/
• Local length-prefixed JSON TCP bridge 에 127.0.0.1:9881
• MCP 백엔드 엔드포인트 127.0.0.1:8766/mcp
• 게이트웨이 엔드포인트 127.0.0.1:9765/mcp
• 현장 검사, 그래프 인증 및 참조 조회에 대한 번들 기술
• 실행된 물질 디자이너 인스턴스 없이 정상적인 CI를 위한 가짜 호스트 테스트
• 실제 호스트 세션을 위한 Opt-in 라이브 통합 및 mutation 테스트
• Redistributing Adobe 또는 PySide API stubs없이 편집기 지원을위한 로컬 stub 발전기

상태

이 프로젝트는 초기 0.1.x 어댑터입니다. Normal CI는 가짜 호스트 테스트를 사용하고 있습니다. Substance Designer가 필요하지 않습니다. Live host checks are opt-in 과 요구 Substance 3D Designer 16.0+ 이 저장소의 플러그인로드. Mutation 시험

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: