@imagerry/cli 0.1.6-beta → 0.1.8-beta

package/README.md

@@ -18,6 +18,7 @@ The official command-line interface for [Imagerry](https://imagerry.com), built
 
 * 🖥️ Process images directly from the terminal
 * 🌐 **New:** Host a self-hosted API server with `serve`
+* 🧠 **New:** Model Context Protocol (MCP) server support for AI agents (Claude Desktop, Cursor, Zed)
 * 🔒 Keep image processing completely local
 * 🎨 Apply built-in styling presets
 * ⚙️ Create and reuse custom JSON presets
@@ -38,28 +39,32 @@ Verify the installation:
 imagerry -h
 ```
 
-## Licensing
+## Free Tier & Licensing
 
-Imagerry CLI requires an **Imagerry Pro** license.
+Imagerry CLI includes a **Free Tier** that allows you to process up to **15 free images per day** without requiring a license key.
 
-You can provide your license key in either of the following ways.
+For unlimited daily processing, automated loops/batch scripts, or hosting the self-hosted `serve` API and `mcp` server, an **[Imagerry Pro](https://imagerry.com/pro)** license is required.
 
-### Command-line option
+### Using Pro License
+
+You can provide your license key in either of the following ways:
+
+#### Command-line option
 
 ```bash
 imagerry --input=input.png --output=output.png --license-key=YOUR_KEY
 ```
 
-### Environment variable
+#### Environment variable
 
-For automation and CI/CD environments, using an environment variable is recommended:
+For automation, Docker, and CI/CD environments:
 
 ```bash
 export IMAGERRY_LICENSE_KEY="YOUR_KEY"
 ```
 
 > [!TIP]
-> The CLI verifies your license with the payment server, but CLI usage does **not count against your device limit**. This makes it suitable for automated environments such as GitHub Actions, Docker, and CI/CD pipelines.
+> CLI usage does **not count against your device limit**. You can use your Pro license freely across your local terminal, Docker containers, and CI/CD pipelines.
 
 ## Usage
 
@@ -172,6 +177,37 @@ The server also exposes a few helpful informational routes:
 - `GET /template` — Returns a JSON object of all available settings keys and their defaults.
 - `GET /health` — Returns server health status and engine version.
 
+## Model Context Protocol (MCP) Server
+
+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.
+
+### Starting the MCP Server
+
+```bash
+imagerry mcp
+```
+
+### Claude Desktop Configuration
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "imagerry": {
+      "command": "imagerry",
+      "args": ["mcp"],
+      "env": {
+        "IMAGERRY_LICENSE_KEY": "YOUR_PRO_LICENSE_KEY"
+      }
+    }
+  }
+}
+```
+
+### Registered Tools
+* **`customize_image`**: Applies presets, gradients, and custom styles to local images (`inputPath`, `outputPath`, `preset`, `mode`).
+
 ## Automation
 
 Imagerry CLI is designed to work well in automated environments.
@@ -209,4 +245,5 @@ The CLI only communicates with the licensing service when verifying your Imagerr
 ## Links
 
 * [Imagerry](https://imagerry.com)
+* [Imagerry Pro](https://imagerry.com/pro)
 * [Legal & Terms](https://imagerry.com/legal)

package/bin/imagerry.js

@@ -12,28 +12,14 @@ const packageName = `@imagerry/cli-${platform}-${arch}`;
 
 try {
   const require = createRequire(import.meta.url);
-  
+
   // Resolve the platform-specific package
   const pkgPath = require.resolve(`${packageName}/package.json`);
   const pkgDir = path.dirname(pkgPath);
-  
-  // if (platform === 'android') {
-  //   const entryPath = path.join(pkgDir, 'index.cjs');
-  //   if (!fs.existsSync(entryPath)) {
-  //     throw new Error(`Android JS entry not found at ${entryPath}`);
-  //   }
-  //   const { status, signal, error } = spawnSync('node', [entryPath, ...process.argv.slice(2)], {
-  //     stdio: 'inherit',
-  //   });
-  //   
-  //   if (error) throw error;
-  //   if (signal) process.exit(1);
-  //   process.exit(status ?? 0);
-  // }
 
   const binName = platform === 'win32' ? 'imagerry.exe' : 'imagerry';
   const binPath = path.join(pkgDir, binName);
-  
+
   if (!fs.existsSync(binPath)) {
     throw new Error(`Native binary not found at ${binPath}`);
   }
@@ -42,6 +28,10 @@ try {
   const { status, signal, error } = spawnSync(binPath, process.argv.slice(2), {
     stdio: 'inherit',
     windowsHide: true,
+    env: {
+      ...process.env,
+      IMAGERRY_INSTALLED_BY: 'npm',
+    },
   });
 
   if (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@imagerry/cli",
-  "version": "0.1.6-beta",
+  "version": "0.1.8-beta",
   "description": "Command-line interface for the Imagerry engine",
   "homepage": "https://cli.imagerry.com",
   "repository": {
@@ -23,12 +23,13 @@
     "imagerry": "bin/imagerry.js"
   },
   "optionalDependencies": {
-    "@imagerry/cli-darwin-arm64": "0.1.6-beta",
-    "@imagerry/cli-darwin-x64": "0.1.6-beta",
-    "@imagerry/cli-linux-arm64": "0.1.6-beta",
-    "@imagerry/cli-linux-x64": "0.1.6-beta",
-    "@imagerry/cli-win32-arm64": "0.1.6-beta",
-    "@imagerry/cli-win32-x64": "0.1.6-beta"
+    "@imagerry/cli-android-arm64": "0.1.8-beta",
+    "@imagerry/cli-darwin-arm64": "0.1.8-beta",
+    "@imagerry/cli-darwin-x64": "0.1.8-beta",
+    "@imagerry/cli-linux-arm64": "0.1.8-beta",
+    "@imagerry/cli-linux-x64": "0.1.8-beta",
+    "@imagerry/cli-win32-arm64": "0.1.8-beta",
+    "@imagerry/cli-win32-x64": "0.1.8-beta"
   },
   "keywords": [
     "image",
@@ -44,6 +45,6 @@
   "author": "Imagerry <support@imagerry.com>",
   "license": "SEE LICENSE IN LICENSE.md",
   "imagerry": {
-    "minimumVersion": "0.1.0-beta"
+    "minimumVersion": "0.1.7-beta"
   }
 }