ES

elliezu/substancepaintermcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

51 stars 14 forks 品質 78 トレンド 17MIT

物質画家 MCP サーバー

概要

ローカルのAdobe Substance 3D Painter プロジェクトからAIクライアントの検査、監査、編集、およびエクスポートを可能にするMCPサーバー。 バージョンは、79のMCPツールを提供しています。 ガードされたリソースワークフローを棚の発見、永続的な棚のインポート、およびイベント主導の棚のリフレッシュジョブで完了し、計画されたプロジェクトライフサイクル、生産ベーキング、およびトランザクションレイヤーのオーサリングが0.xリリース全体に追加されます。 生き残っています。 これは、独立したコミュニティプロジェクトであり、Adobeが承認または承認されていない。 - オープンプロジェクト、テクスチャセット、チャンネル、リソース、エクスポートプリセット、およびレイヤーツリーの完成を調べます。 - 安定した層UIDで塗りつぶし、塗りつぶし、グループレイヤーを作成します。 - ステップが失敗すると、ネストされたレイヤーのレシピを原子状に作成し、作成されたすべてのノードをロールバックします。 - 実行前に承認された.sppバックアップを作成するオプションで、ミューテーションなしでレシピスコープとチャネルの解像度を計画します.

概要(AI 翻訳)

ローカルのAdobe Substance 3D Painter プロジェクトからAIクライアントの検査、監査、編集、およびエクスポートを可能にするMCPサーバー。

バージョン1.0.0は79のMCPツールを提供しています。 ガードされたリソースワークフローを棚の発見、永続的な棚のインポート、およびイベント主導の棚のリフレッシュジョブで完了し、計画されたプロジェクトライフサイクル、生産ベーキング、およびトランザクションレイヤーのオーサリングが0.xリリース全体に追加されます。 Substance 3D Painter 12.1.1 に対してライブ検証されます。

これは、独立したコミュニティプロジェクトであり、Adobeに所属または支持されていない。

##ハイライト

  • オープンプロジェクト、テクスチャセット、チャンネル、リソース、エクスポートプリセット、およびレイヤーツリーの完成を調べます。
  • 安定した層UIDで塗りつぶし、塗りつぶし、グループレイヤーを作成します。
  • ステップが失敗すると、ネストされたレイヤーのレシピを原子状に作成し、作成されたすべてのノードをロールバックします。
  • 実行前に承認された[.spp]のバックアップを作成するオプションで、ミューテーションなしでレシピスコープとチャネルの解像度を計画します。
  • OpenPBR-aware 塗りつぶしチャンネル、マスク、可視性、不透明度、ブレンドモード、名前、選択を設定します。
  • メッシュまたは UDIM ジオメトリマスクを制御し、UID による詳細なレイヤースナップショットを比較します.

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。

README

以下は原文 README の抜粋です。原文を見る。

Substance Painter MCP

An MCP server that lets AI clients inspect, audit, edit, and export from a local Adobe Substance 3D Painter project.

Version 1.0.0 provides 79 focused MCP tools. It completes the guarded resource workflow with shelf discovery, persistent shelf imports, and event-driven shelf refresh jobs, on top of the planned project lifecycle, production baking, and transactional layer authoring added throughout the 0.x releases. It is live-validated against Substance 3D Painter 12.1.1.

This is an independent community project and is not affiliated with or endorsed by Adobe.

Highlights

  • Inspect the open project, Texture Sets, channels, resources, export presets, and complete layer tree.
  • Create and edit Fill, Paint, and Group layers through stable layer UIDs.
  • Build nested layer recipes atomically and roll back every created node if a step fails.
  • Plan recipe scope and channel resolution without mutation, optionally creating an approved .spp backup before execution.
  • Set OpenPBR-aware Fill channels, masks, visibility, opacity, blend modes, names, and selection.
  • Control Mesh or UDIM geometry masks and compare detailed layer snapshots by UID.
  • Insert Fill, Paint, Generator, Filter, Levels, Anchor, and Smart Mask effects into mask stacks.
  • Apply shelf Smart Materials/Masks and configure UV or Triplanar Fill transforms.
  • Assign shelf resources to individual Fill channels or complete materials.
  • Import safe visual resources from approved roots into the project, current Painter session, or a writable shelf.
  • Discover configured shelves and monitor explicit shelf-index refreshes through persistent event-backed jobs.
  • Inspect and edit typed procedural Substance parameters, including colors and enum labels.
  • Inspect, connect, reset, and transactionally restore procedural image inputs on Fill, Generator, and Filter sources.
  • Discover Anchor Points with owner context and connect them to Fill channels or materials.
  • Configure Planar, Spherical, and Cylindrical projection transforms and culling.
  • Inspect and transactionally configure common baking properties, individual bakers, UV tiles, and linked Texture Set impact.
  • Assign high-poly and cage meshes only from approved roots, then capture or apply portable baking presets.
  • Preflight and batch-bake multiple Texture Sets with optional backup, cancellation, state restoration, and per-map verification.
  • Preflight and monitor mesh reloads while preserving strokes and reporting Texture Set changes.
GitHub で README 全文を見る

インストール

This server does not publish a one-line install command.

Open the repository installation guide MCP 初心者?mcpskill.org のガイドから始めましょう →

設定

{ "mcpServers": { "substance-painter": { "command": "C:\\Tools\\SubstancePainterMCP\\.venv\\Scripts\\python.exe", "args": ["-m", "substance_painter_mcp"], "env": { "SP_MCP_TIMEOUT": "120", "SP_MCP_EXPORT_ROOTS": "D:\\SubstanceExports", "SP_MCP_PROJECT_ROOTS": "D:\\SubstanceBackups", "SP_MCP_MESH_ROOTS": "D:\\Meshes", "SP_MCP_BAKE_MESH_ROOTS": "D:\\BakeMeshes", "SP_MCP_RESOURCE_ROOTS": "D:\\SubstanceResources" } } } }