Адаптер для адаптера DCC Model Context Protocol (MCP).

Это хранилище обеспечивает адаптер Python MCP и поддерживаемую Adobe Substance. Плагин 3D Designer host. Он использует dcc-mcp-core для общего MCP-сервера контракты, загрузка навыков и интеграция шлюзов, в то время как вещество Конкретное для дизайнера поведение моста, инструменты графов и команды плагинов принадлежат Вот.

Особенности

• Принадлежащий репозиторию плагин Substance Designer под plugin/
• Местный мост JSON TCP на 127.0.0.1:9881
• MCP backend endpoint on 127.0.0.1:8766/mcp
• конечная точка шлюза 127.0.0.1:9765/mcp
• Связанные навыки для осмотра сцены, написания графика и поиска ссылок
• Фальшивые тесты хоста для обычного CI без запуска экземпляра Substance Designer
• Отказ от живой интеграции и мутационных тестов для реальной сессии хоста
• локальный генератор заглушек для помощи редакторам без перераспределения заглушек Adobe или PySide API;

Статус

Этот проект является ранним адаптером 0.1.x. CI использует поддельные тесты хостов и Не требует наличия дизайнера. Проверки хоста в реальном времени являются обязательными и требуют Вещество 3D Designer 16.0+ с загруженным плагином этого хранилища. Тесты на мутацию

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: