@imagerry/cli 0.1.7-beta → 0.1.9-beta

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +42 -8
  2. package/package.json +8 -8
package/README.md CHANGED
@@ -18,6 +18,7 @@ The official command-line interface for [Imagerry](https://imagerry.com), built
18
18
 
19
19
  * 🖥️ Process images directly from the terminal
20
20
  * 🌐 **New:** Host a self-hosted API server with `serve`
21
+ * 🧠 **New:** Model Context Protocol (MCP) server support for AI agents (Claude Desktop, Cursor, Zed)
21
22
  * 🔒 Keep image processing completely local
22
23
  * 🎨 Apply built-in styling presets
23
24
  * ⚙️ Create and reuse custom JSON presets
@@ -83,25 +84,27 @@ imagerry -i input.png -o output.png
83
84
 
84
85
  ## Built-in Presets
85
86
 
86
- To view a full list of available built-in styles and their descriptions, run:
87
+ Imagerry comes with built-in styling presets (such as `mesh`, `gradient`, `cyberpunk`, `aurora`, `sunset`, `studio`, and `default`).
88
+
89
+ To view the full list of available presets and their descriptions, run:
87
90
 
88
91
  ```bash
89
92
  imagerry --list-presets
90
93
  ```
91
94
 
92
- Once you've found a style you like, you can apply it using the `--preset` flag:
95
+ Once you've found a style you like, apply it using the `--preset` flag:
93
96
 
94
97
  ```bash
95
- imagerry --input=input.png --output=output.png --preset=mesh
98
+ imagerry -i input.png -o output.png --preset=mesh
96
99
  ```
97
100
 
98
101
  ## Custom JSON Presets
99
102
 
100
- For more control over the output, Imagerry supports custom JSON presets.
103
+ For complete control over every visual attribute, Imagerry supports custom JSON presets matching the full capabilities of the image customizer engine.
101
104
 
102
105
  ### 1. Export a preset template
103
106
 
104
- Generate a starting configuration:
107
+ Generate a starting configuration with all supported settings:
105
108
 
106
109
  ```bash
107
110
  imagerry --export-preset-template=my-style.json
@@ -166,16 +169,47 @@ curl -f -X POST http://localhost:5273/api/v1/process \
166
169
  > [!WARNING]
167
170
  > We strongly recommend including the `-f` (or `--fail-with-body`) flag when using `curl` with `--output`. If the API returns an error, this flag prevents `curl` from saving the JSON error response directly into your output image file, which would result in a corrupted image.
168
171
 
169
- ### Built-in API Reference
172
+ ### API Documentation
170
173
 
171
- Once the server is running, visit **`http://localhost:5273/docs`** in your browser to view the API reference.
174
+ Explore the full API documentation, parameter specifications, and integration guides at **[imagerry.com/cli/docs/serve-api](https://imagerry.com/cli/docs)**.
172
175
 
173
- The server also exposes a few helpful informational routes:
176
+ The server also exposes helpful informational routes:
174
177
 
175
178
  - `GET /presets` — Returns a JSON array of all built-in named presets.
176
179
  - `GET /template` — Returns a JSON object of all available settings keys and their defaults.
177
180
  - `GET /health` — Returns server health status and engine version.
178
181
 
182
+ ## Model Context Protocol (MCP) Server
183
+
184
+ Imagerry CLI includes an official **Model Context Protocol (MCP)** server that exposes local image styling and formatting tools directly to AI assistants like Claude Desktop, Cursor, and Zed.
185
+
186
+ ### Starting the MCP Server
187
+
188
+ ```bash
189
+ imagerry mcp
190
+ ```
191
+
192
+ ### Claude Desktop Configuration
193
+
194
+ Add the following to your `claude_desktop_config.json`:
195
+
196
+ ```json
197
+ {
198
+ "mcpServers": {
199
+ "imagerry": {
200
+ "command": "imagerry",
201
+ "args": ["mcp"],
202
+ "env": {
203
+ "IMAGERRY_LICENSE_KEY": "YOUR_PRO_LICENSE_KEY"
204
+ }
205
+ }
206
+ }
207
+ }
208
+ ```
209
+
210
+ ### Registered Tools
211
+ * **`customize_image`**: Applies presets, gradients, and custom styles to local images (`inputPath`, `outputPath`, `preset`, `mode`).
212
+
179
213
  ## Automation
180
214
 
181
215
  Imagerry CLI is designed to work well in automated environments.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@imagerry/cli",
3
- "version": "0.1.7-beta",
3
+ "version": "0.1.9-beta",
4
4
  "description": "Command-line interface for the Imagerry engine",
5
5
  "homepage": "https://cli.imagerry.com",
6
6
  "repository": {
@@ -23,13 +23,13 @@
23
23
  "imagerry": "bin/imagerry.js"
24
24
  },
25
25
  "optionalDependencies": {
26
- "@imagerry/cli-darwin-arm64": "0.1.7-beta",
27
- "@imagerry/cli-darwin-x64": "0.1.7-beta",
28
- "@imagerry/cli-linux-arm64": "0.1.7-beta",
29
- "@imagerry/cli-linux-x64": "0.1.7-beta",
30
- "@imagerry/cli-win32-arm64": "0.1.7-beta",
31
- "@imagerry/cli-win32-x64": "0.1.7-beta",
32
- "@imagerry/cli-android-arm64": "0.1.7-beta"
26
+ "@imagerry/cli-android-arm64": "0.1.9-beta",
27
+ "@imagerry/cli-darwin-arm64": "0.1.9-beta",
28
+ "@imagerry/cli-darwin-x64": "0.1.9-beta",
29
+ "@imagerry/cli-linux-arm64": "0.1.9-beta",
30
+ "@imagerry/cli-linux-x64": "0.1.9-beta",
31
+ "@imagerry/cli-win32-arm64": "0.1.9-beta",
32
+ "@imagerry/cli-win32-x64": "0.1.9-beta"
33
33
  },
34
34
  "keywords": [
35
35
  "image",