Repository navigation
Releases
Releases · cavi-ai/substance-mcp
v0.13.0
Changed
- Requires Python 3.15 or newer; scripts embedded in Substance applications retain Python 3.11 compatibility.
- Use MCP Core for application discovery, tool responses, schemas, and subprocess execution.
Fixed
- Match Designer input bounds to native property types and set graph resolutions with absolute inheritance.
- Declare Designer resource status fields and reject undeclared tool arguments.
- Start Painter in the background when requested.
v0.12.0
Added
- Shared precision-preserving texture readers, original storage descriptors and PNG16 writing for material handoffs.
- Canonical pure response-schema helpers for independent MCP adapters.
v0.9.0
Added
- Declared response fields for all Painter, Designer and Sampler tools.
- Action-specific response validation that preserves existing wire shapes and extra details.
- Report output conversion failures as uncertain outcomes without suggesting a retry.
v0.8.1
Fixed
- Report unknown tool names as rejected requests with a tool-discovery recovery hint.
v0.8.0
Added
- Declared status responses for Painter, Designer and Sampler, plus ownership, texture export and bake results.
- Structured failure codes, outcome and recovery hints alongside readable MCP errors.
Changed
- Omit redundant discovery schema titles without changing validation constraints.
v0.7.1
Fixed
- A process that only names an application's binary as an argument, such as Adobe's IPC
broker (-launchedbyvulcan <executable>), no longer counts as that application running;
a binary must be the process's first argument.
v0.7.0
Added
- MIT
LICENSE. - Governance files:
SECURITY.md(private vulnerability reporting and scope),CONTRIBUTING.md,
.pr-gates(the commands CI runs), issue forms, a pull request template and a Dependabot
configuration foruv,npmand GitHub Actions. - Trademark and non-affiliation notice in the README.
- Versioned documentation for cavi-ai.xyz in
docs/substance-mcp/source; the release workflow
builds, verifies and attaches it to each GitHub release, and the README links to it instead of
repeating it. - CI on Linux, macOS and Windows across Python 3.11-3.13 with pinned actions, a lowest-dependency
leg, CodeQL, a package smoke test (npm run verify:package), a tag-driven release workflow
with PyPI trusted publishing, and a nightly upgrade and vulnerability canary. Install with
uv tool install cavi-substance-mcp. - Windows support for Designer and Sampler: default install paths under
Program Files
(%ProgramFiles%is honoured),tasklistto see whether an application is running,
taskkill /T /Fto end a timed-out tool and everything it started, and read-only files are
cleared when a failed output is removed. The fake Designer and Sampler programs install as
.cmdlaunchers on Windows, so the tests can run there. The Windows CI leg stays
experimental until it has run green on a real runner. - Designer and Sampler executables are also found on
PATH, after an environment override
and the platform's default install location. CAVI_SAMPLER_SCRIPT_PATHoverrides the startup-scripts foldersampler_statusreports.- An import-closure test proves the code that runs inside Painter and Sampler imports only the
standard library and, for Sampler, no host-side module.
Changed
- Requires the MCP Python SDK 2.3 or later. The servers use its
MCPServerand re-raise
anticipated failures (invalid arguments, refused paths, an unavailable or busy
application) as tool errors, so their messages still reach the client; other exceptions
are reported without their details. - Pillow requires 13.0 or later; the locked 12.3.0 had known vulnerabilities fixed in 13.0.0.
- Package metadata: readme, MIT license expression and license file, authors, keywords,
classifiers, project URLs and a description naming all three applications. The build
requireshatchling>=1.27. - The source distribution contains only
src/,tests/,evals/,examples/, the README,
LICENSE,CHANGELOG.mdandpyproject.toml. - Ruff checks the
E,F,I,B,UPandSIMrule sets, including the 100-character line
limit (E501). .gitignorecovers local plans, worktrees, editor state, logs, build output and Substance
.ssaand.sptfiles.- Receipt verification is its own command,
cavi-substance-receipts verifyandchain
(modulecavi_substance_mcp.receipts_cli), shared by all three servers. It replaces
cavi-substance-mcp receipts ..., which is removed; the arguments, output and exit codes
are unchanged.npm run verify:packageruns it from the installed wheel. - The Painter server lives in the
cavi_substance_mcp.paintersubpackage, like Designer and
Sampler:server,client,runtimeandclimoved there under the same names, and
painter_operationsis nowpainter.operations.cavi-substance-mcpruns
cavi_substance_mcp.painter.server:main, and the module to run withpython -mis
cavi_substance_mcp.painter.server. The old import paths are gone; there are no aliases.
Changed (breaking)
- The default workspace is
~/Documents/SubstanceMCP; setCAVI_SUBSTANCE_WORKSPACEto keep
using a previous folder. Only the default is created on
demand. A workspace named byCAVI_SUBSTANCE_WORKSPACEmust already exist, and a missing one
is refused with a message instead of being created. Read-only calls never create it; a Sampler
call does, because it holds its lock file there. SAMPLER_SCRIPT_PATHis read asCAVI_SAMPLER_SCRIPT_PATHfor the scripts folder that
sampler_statusreports, with no alias. The variable each launch sets for the Sampler it
starts is still Adobe's ownSAMPLER_SCRIPT_PATH.- The deprecated Designer
samplertool is removed, anddesigner_statusno longer has a
samplerentry. Usecavi-substance-sampler-mcp. designer_statusno longer listssbsupdater, which no operation uses.- Painter no longer adopts edit-lease state left by lease versions that were never released
(_cavi_mcp_lease_v2and the unversioned attribute). - Painter:
bakegainsaction="cancel". Deleting a node whose subtree holds layers this
lease did not create requiresconfirm_name.layer_edittimes out after 120 seconds. - Sampler:
sampler_builddefaults todry_run=true.sampler_asset action="delete"
requiresconfirm=true, andsampler_assetandsampler_layerare annotated
destructive.sampler_inspect action="project"requiresproject.sampler_export
rejectstargetwith a non-imageformatinstead of switching it to PNG. Creating an
asset whose name already exists is refused. - Receipts: inputs supplied by an application, such as a Designer built-in template, are
recorded as schema 2app-resourcerows (name, SHA-256 and tool version) instead of
absolute paths. Receipts without such inputs stay schema 1, and both schemas are read.
Recording a missing file or a path outside the workspace is an error. - Sampler job manifests are standard receipts: workspace-relative paths only, per-export
receipts listed as outputs, and atomic writes. The top-levelapp_name,workspaceand
app.executablefields are gone.
Fixed
- Sampler refuses a resource that changed while it was imported instead of reporting it
verified. - Batch preflight reports a step that names a duplicated asset as ambiguous.
- Channel packing quantizes each plane straight into the output image and frees sources
after their last use, and refuses packs that would decode more than 2 GiB. - Painter accepts schema 2 receipts as
source_manifestand refuses to record a missing
output; it now uses the shared receipts module instead of its own drifted copy. - A Designer or Sampler program whose grandchild kept its output pipe open held the call until
the timeout and then reported a timeout for a run that had already finished. A call now ends
when the process exits. - Designer output that exceeds the limit is no longer silently shortened: a cut
sbsrender
report is an error and error messages say when output was dropped. - A timed-out Designer tool is asked to stop (SIGTERM) before it is killed, like Sampler.
runtime startrefuses to launch when it cannot tell whether Painter is already running.serverInfo.versionreports the package version instead of the MCP SDK version.- Painter tool calls run off the event loop and are serialized, so a long call no longer
blocks other requests, and a request cancelled while queued is never sent. - A lost bake end event no longer blocks every later Painter call.
.sbsarimports use the bytes that were hashed.wait_readyrequires that Painter is not baking and no mesh reload is pending.- Failed exports and
save_copycalls remove the directory they created. - Non-ASCII lease ids, enum non-members as
blend_mode, non-booleandry_runvalues and
duplicate names on rename are rejected. - Painter transport errors and HTTP 5xx responses are reported as unavailable, and each
request has a wall-clock deadline. - Sampler batch exports work for asset names that are not already directory-safe.
- The
--versionprobe of a Designer or Sampler program waits at most 5 s instead of 20 s, and a
Sampler launch counts it against the call's timeout instead of adding to it. - Receipts, batch job files and Painter's
source_manifestlarger than 8 MiB are refused with
a message instead of being read whole. - When a failed Designer or Sampler operation cannot remove the output directory it created,
the error names what is left. - A cancelled batch job releases the workspace lock and removes its directory.
- Every Sampler launch takes the workspace lock.
- Single Sampler operations edit a copy of the project and replace it only on success.
- A non-zero Sampler exit fails the call.
- Target exports wait for every expected map to be complete, with no file changing size for one
second, before hashing; a pause in Sampler's flush no longer records a partial file. - Job validation applies the runtime's naming rules before Sampler launches.
- A job whose input changes while it runs fails.
- A batch job saves its project before an export when it has unsaved changes, so each export
receipt records the project it was exported from and a new project's first export no longer
fails on a missing.ssa. - The Painter simulator in
evals/accepts only the two expressions the client sends and no
longer evaluates request text.