MCP.Market

Compositor MCP server

by Josusanz·io.github.Josusanz/compositor·v0.1.4·8 stars
No reviews yet

Read and edit Compositor .comp projects: layers, folders, masks, transforms, previews and exports

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

8 stars81 downloads/wk

Reviews

Write one

Nobody has reviewed Compositor yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Compositor tools (15, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_folderwrite action

    Creates an empty layer folder (group).

  • add_image_layer

    Imports an image file (PNG, JPEG, HEIC, TIFF, WebP…) as a new pixel layer. The pixels are stored as-is; the placement only sets the layer's transform.

  • create_projectwrite action

    Creates a new empty .comp project. Optionally adds a solid background layer. Overwrites the manifest of an existing package at that path.

  • export_flattened

    Renders the whole project at full resolution to a PNG or JPEG file.

  • export_layer

    Copies a pixel layer's source PNG (untransformed, original resolution) or its mask to a file.

  • inspect_project

    Reads a Compositor .comp project and returns the canvas info plus every layer in stacking order (bottom to top), with folder depth, visibility, opacity, blend mode and transform.

  • list_layers

    Compact list of layers (id, name, kind, visibility) from top to bottom as shown in Compositor's Layers panel.

  • move_layer

    Reorders a layer (with its subtree if it is a folder): to the top or bottom of a folder or the root, or directly above/below another layer.

  • open_in_compositor

    Opens (or reloads) the project in the Compositor app on this Mac so the user can see the result. Compositor reads the package from disk on open.

  • remove_layerwrite action

    Deletes a layer (and, for a folder, everything inside it) together with its image and mask files.

  • render_preview

    Flattens the project and returns a PNG preview image so the model can see the composition. Optionally saves it to a file. Clipping masks, adjustment layers and layer effects are not rendered; the response lists what was skipped.

  • replace_layer_image

    Swaps the source pixels of a pixel layer with another image file, keeping its transform, mask and properties. Use it to round-trip a layer through an external editor or a generated image.

  • resize_canvas

    Changes the document size without resampling layers. Layers keep their pixels and are offset according to the anchor.

  • set_layer

    Changes name, visibility, opacity, blend mode, mask enablement or transform (origin, size, rotation, flips) of a layer. Only the given fields change.

  • set_layer_mask

    Attaches a raster mask from a grayscale image (white reveals, black hides) to a layer, or removes the existing mask. The mask is stretched over the layer's own rectangle.

Public scan report

scanner v0.1.10 · 2026-11-02 · same rubric, same numbers if you re-run it

no findings
  • Code scan4 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 38 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Compositor compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,255 servers
Tools
15
the typical server has 7
Tools that change things
20%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
8
more than 86% of 28,688 servers
Downloads a week
81
more than 58% of 12,191 servers with a package

What its tools let an agent do: 6 read · 4 create · 4 change · 1 delete

Release history: 2 versions in the registry since 2026-09-22, latest 2026-09-25, typically one every 3 days.

Install Compositor in Claude Code, Cursor or VS Code

Runs npx -y compositor-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add compositor -- npx -y compositor-mcp
Add to Cursor

What the publisher says

From the Compositor repository's README, as published. We do not edit it. Read it on GitHub

compositor-mcp

An MCP server that lets Claude and other AI agents read and edit Compositor projects, the open-source Photoshop alternative for Mac.

It works on the documented .comp package format (a manifest.json plus one PNG per layer), so it needs no changes to Compositor itself. Edit a project with an agent, then open it in Compositor. Or the other way round: save in Compositor and let the agent inspect, retouch or render it.

What the agent can do

The server also exposes a compositor://format resource describing the file format.

Install

Requires Node.js 20 or later. Compositor itself is only needed to look at the result.

Claude Code

claude mcp add compositor -- npx -y compositor-mcp

Claude Desktop

Add to claudedesktopconfig.json:

{
  "mcpServers": {
    "compositor": {
      "command": "npx",
      "args": ["-y", "compositor-mcp"]
    }
  }
}

From source

git clone https://github.com/Josusanz/compositor-mcp
cd compositor-mcp
npm install
npm run build
claude mcp add compositor -- node /path/to/compositor-mcp/dist/src/index.js

Example session

Create a 1920×1080 project at ~/Desktop/poster.comp with a white background, add photo.jpg

scaled to fill, put logo.png in the bottom right corner at 80 % opacity with Multiply, then show

me a preview and open it in Compositor.

The agent calls createproject, addimagelayer twice, setlayer, renderpreview and openin_compositor. Compositor opens the document with the layers ready to keep editing.

How it maps to the Compositor format

in the layer transform, so edits stay non-destructive.

  • Layer pixels are stored untouched as 8-bit sRGB PNGs; placement, scale, rotation and flips live

with sorted keys and replaced atomically.

  • Masks are written as 8-bit grayscale PNGs without alpha, as Compositor requires.
  • Manifests are validated against the same rules as ProjectStore.swift before writing, written

are preserved on round trip.

  • Fields this tool does not understand (adjustments, effects, text, shapes, guides, anything newer)

newer versions; update the app if a file will not open.

  • Projects are always saved as format version 8 (the current one). Older Compositor builds reject

Limitations

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Compositor: common questions

Is Compositor MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Compositor safety report
How do I install Compositor?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Compositor need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Compositor maintained?
The last commit was 40 days ago (2026-09-25). The latest release is v0.1.4.
How does Compositor compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,255 servers); tools 15 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.