DCCモデルコンテキストプロトコル(MCP)エコシステム用のSubstance Designerアダプタ。

このリポジトリは、Python MCP アダプターと維持された Adobe の Substance を提供します。 3D Designer ホストプラグイン 使用している [dcc-mcp-core] 共有 MCP サーバー 契約、スキルのロード、ゲートウェイの統合、Substance デザイナー固有のブリッジの動作、グラフツーリング、プラグインのコマンドは所有 詳しくはこちら

##特徴

• [plugin/下にあるリポジトリ所有のSubstance Designerプラグイン]
• ローカル長プレフィックスJSON TCPブリッジ [127.0.0.1:9881]
• MCP バックエンドエンドポイント [127.0.0.1:8766/mcp
• ゲートウェイエンドポイント [127.0.0.1:9765/mcp
• シーンの検査、グラフのオーサリング、および参照のルックアップのためのバンドルされたスキル
• 実行中のSubstance Designerインスタンスなしで通常のCI用のFake-hostテスト
• 実際のホストセッションのOpt-inライブインテグレーションとミューテーションテスト
• AdobeまたはPySide APIのスタブを再配布することなく、エディタのヘルプのためのローカルスタブジェネレータ

ステータス

このプロジェクトは初期の[0.1.xアダプタです。 通常のCIは擬似ホストテストを使用し、 Substance Designer を必要としません。 ライブホストチェックはオプトインされ、必要に応じて このリポジトリのプラグインが読み込まれたSubstance 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: