** Adobe Substance 3D Designer에 대한 최초의 MCP (모델 Context Protocol) 통합. **

MCP 호환 AI 클라이언트 (Claude Code, Claude Desktop, Cursor)의 제어 물질 디자이너 - 그래프를 만들, 노드를 구축, 연결, 설정 매개 변수, 단일 프롬프트에서 전체 PBR 재료 그래프를 생성.

---

무엇 그것

• Natural 언어 → SD graph: “Create cracked Concrete material” → 44-node PBR graph with height, normal, 거칠기, AO, BaseColor, 금속 출력
• ** 79 내장 재료 레시피 ** : 전문 SD 아티스트와 동일한 노드 아키텍처를 사용하여 고급 재료
• 16 MCP 도구: 장면 정보, create/delete graphs, create nodes, connect nodes, set Parameter, build full materials in one call -Library 노드 지원: Clouds, Cells, Perlin Noise, Polygon, Edge Detect, Flood Fill, Multi-Directional Warp 등
• ** 안전 **: Signal/Slot queued 연결을 통해 Qt 메인 스레드에 파견 된 모든 SD API 호출

---

건축

브리지와 플러그인은 간단한 길이 - 접두사 framing 프로토콜과 통신 : [4-byte big-endian length][JSON payload]. 각 명령은 신선한 TCP 소켓을 사용합니다 - 영구 연결 없음, stale 상태.

---

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"
      ]
    }
  }
}