@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.
- package/README.md +42 -8
- 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
|
-
|
|
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,
|
|
95
|
+
Once you've found a style you like, apply it using the `--preset` flag:
|
|
93
96
|
|
|
94
97
|
```bash
|
|
95
|
-
imagerry
|
|
98
|
+
imagerry -i input.png -o output.png --preset=mesh
|
|
96
99
|
```
|
|
97
100
|
|
|
98
101
|
## Custom JSON Presets
|
|
99
102
|
|
|
100
|
-
For
|
|
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
|
-
###
|
|
172
|
+
### API Documentation
|
|
170
173
|
|
|
171
|
-
|
|
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
|
|
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.
|
|
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-
|
|
27
|
-
"@imagerry/cli-darwin-
|
|
28
|
-
"@imagerry/cli-
|
|
29
|
-
"@imagerry/cli-linux-
|
|
30
|
-
"@imagerry/cli-
|
|
31
|
-
"@imagerry/cli-win32-
|
|
32
|
-
"@imagerry/cli-
|
|
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",
|