imgx-cli 0.5.1 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 0.5.2 (2026-02-26)
+
+### Fixed
+
+- `imgx-mcp` bin: added missing shebang (`#!/usr/bin/env node`) — fixes `npx imgx-mcp` and Claude Desktop MCP integration on all platforms
+
+### Changed
+
+- README: add Claude Desktop MCP configuration (Windows `cmd /c` + macOS/Linux)
+- README: switch all MCP config examples from local `node` path to `npx`
+
 ## 0.5.1 (2026-02-26)
 
 ### Added
@@ -10,6 +21,7 @@
 
 ### Changed
 
+- README: added Claude Desktop MCP configuration section with output directory note
 - README: added Google AI Studio link for API key setup, MCP env section note
 
 ## 0.5.0 (2026-02-26)

package/README.md

@@ -206,38 +206,76 @@ Add to your tool's MCP config. The `env` section is optional if you have already
 {
   "mcpServers": {
     "imgx": {
-      "command": "node",
-      "args": ["/path/to/imgx-cli/dist/mcp.bundle.js"],
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
       "env": { "GEMINI_API_KEY": "your-api-key" }
     }
   }
 }
 ```
 
+On Windows, replace `"command": "npx"` with `"command": "cmd"` and prepend `"/c"` to the args array.
+
+Or install as a [Claude Code plugin](#install) for automatic MCP registration.
+
 **Gemini CLI** (`~/.gemini/settings.json`):
 
 ```json
 {
   "mcpServers": {
     "imgx": {
-      "command": "node",
-      "args": ["/path/to/imgx-cli/dist/mcp.bundle.js"],
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
+      "env": { "GEMINI_API_KEY": "your-api-key" }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+macOS / Linux:
+
+```json
+{
+  "mcpServers": {
+    "imgx": {
+      "command": "npx",
+      "args": ["--package=imgx-cli", "-y", "imgx-mcp"],
       "env": { "GEMINI_API_KEY": "your-api-key" }
     }
   }
 }
 ```
 
+Windows:
+
+```json
+{
+  "mcpServers": {
+    "imgx": {
+      "command": "cmd",
+      "args": ["/c", "npx", "--package=imgx-cli", "-y", "imgx-mcp"],
+      "env": { "GEMINI_API_KEY": "your-api-key" }
+    }
+  }
+}
+```
+
+Config file location: `%APPDATA%\Claude\claude_desktop_config.json` (Windows) or `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS). After editing, restart Claude Desktop.
+
+> **Note:** Claude Desktop runs the MCP server from its own app directory. Images will be saved there by default. To control the output location, add `"IMGX_OUTPUT_DIR": "C:\\Users\\you\\Pictures"` to the `env` section, or run `imgx config set output-dir <path>` beforehand.
+
 **Codex CLI** (`.codex/config.toml`):
 
 ```toml
 [mcp_servers.imgx]
-command = "node"
-args = ["/path/to/imgx-cli/dist/mcp.bundle.js"]
+command = "npx"
+args = ["--package=imgx-cli", "-y", "imgx-mcp"]
 env = { GEMINI_API_KEY = "your-api-key" }
 ```
 
-The same configuration pattern works with Cursor, Windsurf, Continue.dev, Cline, Zed, and other MCP-compatible tools.
+The same `npx` pattern works with Cursor, Windsurf, Continue.dev, Cline, Zed, and other MCP-compatible tools. On Windows, use `cmd /c npx` instead of `npx` directly.
 
 ## Architecture
 

package/dist/cli.bundle.js

@@ -39554,7 +39554,7 @@ function showAll() {
 }
 
 // build/cli/index.js
-var VERSION2 = "0.5.1";
+var VERSION2 = "0.5.2";
 var HELP = `imgx v${VERSION2} \u2014 AI image generation and editing CLI
 
 Commands:

package/dist/mcp.bundle.js

@@ -1,3 +1,4 @@
+#!/usr/bin/env node
 import { createRequire } from 'module'; const require = createRequire(import.meta.url);
 var __create = Object.create;
 var __defProp = Object.defineProperty;
@@ -69377,7 +69378,7 @@ function initGemini() {
 // build/mcp/server.js
 var server = new McpServer({
   name: "imgx",
-  version: "0.5.1"
+  version: "0.5.2"
 });
 initGemini();
 function resolveProvider(providerName) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imgx-cli",
-  "version": "0.5.1",
+  "version": "0.5.2",
   "mcpName": "io.github.somacoffeekyoto/imgx",
   "description": "AI image generation and editing CLI with provider abstraction",
   "type": "module",