Первая интеграция MCP (Model Context Protocol) для Adobe Substance 3D Designer.

Control Substance Designer от любого MCP-совместимого ИИ-клиента (Claude Code, Claude Desktop, Cursor) — создавать графики, строить узлы, соединять их, устанавливать параметры, генерировать полные PBR-графы материала из одной подсказки.

Что он делает

• Естественный язык → Граф SD: «Создать треснувший бетонный материал» → 44-узловый ПБР-граф с высотой, нормальной, шероховатостью, АО, базовым цветом, металлическими выходами 79 встроенных рецептов материалов: проградные материалы, использующие ту же архитектуру узлов, что и профессиональные художники SD 16 Инструменты MCP: получать информацию о сцене, создавать/удалять графики, создавать узлы, подключать узлы, устанавливать параметры, создавать полные материалы за один вызов ** Поддержка библиотечных узлов**: облака, ячейки, шум Перлина, полигон, обнаружение края, наводнение, многонаправленное искривление и т.д.

• Безопасно для чтения: Все вызовы SD API отправляются в основной поток Qt через соединение Signal/Slot

Архитектура

Мост и плагин взаимодействуют с простым протоколом фрейминга с префиксом длины: [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"
      ]
    }
  }
}