Adobe Substance 3D Designer 初の MCP (Model Context Protocol) 統合。

MCP 互換の AI クライアント (Claude Code、Claude Desktop、 Cursor) から Substance Designer を制御 — グラフの作成、ノードの構築、ノードの接続、パラメータの設定、フル PBR 素材のグラフを単一のプロンプトから生成します。

お問い合わせ

それが何をするか

• 自然言語→SDのグラフ:「ひび割れたコンクリート材料を作成」→高さ、正常、荒さ、AO、ベースカラー、金属出力の44ノードPBRのグラフ -79 の組み込みの物質的な調理法: 専門 SD の芸術家として同じノードの建築を使用してプロ グレード材料
• 16 MCP ツール: シーン情報の取得、グラフの作成/削除、ノードの作成、ノードの接続、パラメータの設定、フルマテリアルの1つのコールの構築
• ライブラリノードサポート:クラウド、セル、パーリンノイズ、ポリゴン、エッジ検出、フラッドフィラー、マルチ方向ワープなど
• スレッドセーフ: すべてのSD APIは、Signal/Slotキュード接続を介してQtメインスレッドにディスパッチされ、

お問い合わせ

アーキテクチャ

ブリッジとプラグインは、単純な長さプレフィックス・フラミング・プロトコルと通信します。[[4-byte big-endian length][JSON payload]]。 各コマンドは、新しいTCPソケットを使用しており、永続接続なし、スタイル状態はありません。

お問い合わせ

Substance Designer MCP

The first MCP (Model Context Protocol) integration for Adobe Substance 3D Designer.

Control Substance Designer from any MCP-compatible AI client (Claude Code, Claude Desktop, Cursor) — create graphs, build nodes, connect them, set parameters, generate full PBR material graphs from a single prompt.

---

What it does

• Natural language → SD graph: “Create a cracked concrete material” → 44-node PBR graph with height, normal, roughness, AO, baseColor, metallic outputs
• 79 built-in material recipes: pro-grade materials using the same node architecture as professional SD artists
• 16 MCP tools: get scene info, create/delete graphs, create nodes, connect nodes, set parameters, build full materials in one call
• Library node support: Clouds, Cells, Perlin Noise, Polygon, Edge Detect, Flood Fill, Multi-Directional Warp, etc.
• Thread-safe: All SD API calls dispatched to Qt main thread via Signal/Slot queued connection

---

Architecture

AI Client (Claude / Cursor)
        │  stdio (MCP protocol)
        ▼
sd_mcp_bridge.py  (FastMCP server, Python 3.12)
        │  TCP localhost:9881 (length-prefix framing)
        ▼
SD Plugin __init__.py  (Python 3.11, runs inside SD)
        │  sd.api
        ▼
Adobe Substance 3D Designer 15.x

The bridge and plugin communicate with a simple length-prefix framing protocol: [4-byte big-endian length][JSON payload]. Each command uses a fresh TCP socket — no persistent connection, no stale state.

---

Requirements

• Adobe Substance 3D Designer 15.x (tested on 15.0.3)
• Python 3.12+ for the bridge (managed via uv)
• uv package manager: pip install uv or winget install astral-sh.uv
• An MCP-compatible client: Claude Code, Claude Desktop, or Cursor

---

Installation

Step 1 — Install the SD Plugin

Copy the plugin/ folder contents to your SD user scripts directory:

Windows:

%USERPROFILE%\Documents\Adobe\Adobe Substance 3D Designer\python\sduserplugins\sd_mcp_plugin\

The directory must contain:

sd_mcp_plugin/
├── __init__.py    ← main plugin (TCP listener, all MCP tools)
└── recipes.py     ← 79 material recipes

SD auto-loads all plugins from sduserplugins/ on startup. No additional configuration needed.

Step 2 — Install the Bridge Server

cd server/
uv sync   # installs mcp[cli] into .venv

Or with pip:

pip install "mcp[cli]>=1.4.1"

Step 3 — Configure Your MCP Client

Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "substance_designer": {
      "command": "C:\\Users\\YOUR_USERNAME\\.local\\bin\\uv.exe",
      "args": [
        "run",
        "--directory",
        "C:\\PATH\\TO\\substance-designer-mcp\\server",
        "python",
        "sd_mcp_bridge.py",
        "--port",
        "9881"
      ]
    }
  }
}