imgx-mcp 1.1.1 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 1.2.0 (2026-03-04)
+
+### Added
+
+- **MCP roots-based project detection** — MCP server now calls `listRoots()` after connection to get the client's workspace directory, making project-scoped history work without `.imgxrc` when used via Claude Code and other MCP clients
+- **`setProjectRoot()` API** — allows MCP server (or other integrations) to set the project root programmatically
+- **Project-scoped default output** — when a project root is detected, default output directory is `<project-root>/.imgx/` instead of `~/Pictures/imgx`
+- 5 new tests for MCP root detection and project-scoped default output (total: 59 tests)
+
+### Changed
+
+- **Project root resolution priority** — `IMGX_PROJECT_ROOT` env var > MCP roots (`setProjectRoot`) > `.imgxrc` upward search (CLI fallback)
+- **`fallbackOutputDir()`** — configured `outputDir` is now resolved via `resolveProjectPath()` for correct relative path handling
+- **`resetProjectRootCache()`** — now also clears the MCP root value
+
 ## 1.1.1 (2026-03-04)
 
 ### Added

package/README.md

@@ -100,7 +100,7 @@ The skill guides Claude Code through image workflows: blog covers, iterative edi
 | `set_output_dir` | Change the default output directory (optionally move existing files) |
 | `list_providers` | List available providers and capabilities |
 
-Images are saved to `~/Pictures/imgx/<session-id>/` by default. Each session gets its own directory. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
+Images are saved to `<project-root>/.imgx/<session-id>/` when a project root is detected, or `~/Pictures/imgx/<session-id>/` otherwise. Each session gets its own directory. File paths are returned in the response. Inline image preview is included in MCP responses (base64).
 
 ### Iterative editing
 
@@ -377,7 +377,7 @@ Or create manually:
 
 Project config is shared via Git. Do not put API keys in `.imgxrc`.
 
-When `.imgxrc` is present, imgx-mcp treats that directory as the project root. History is saved to `<project-root>/.imgx/output-history.json` (project-scoped, not shared with other projects). Relative paths in `output` and `output_dir` are resolved against the project root instead of the MCP server's working directory.
+When used via MCP (Claude Code, etc.), imgx-mcp automatically detects the project root from the client's workspace via MCP roots. When `.imgxrc` is present, that directory is used as the project root (CLI fallback). You can also set `IMGX_PROJECT_ROOT` environment variable explicitly. History is saved to `<project-root>/.imgx/output-history.json` (project-scoped, not shared with other projects). Default image output goes to `<project-root>/.imgx/<session-id>/`. Relative paths in `output` and `output_dir` are resolved against the project root instead of the MCP server's working directory.
 
 ### Settings resolution
 

package/dist/cli.bundle.js

@@ -22052,9 +22052,12 @@ import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from "n
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import { homedir, platform } from "node:os";
 var _cachedProjectRoot;
+var _mcpRoot = null;
 function findProjectRoot(startDir) {
   if (process.env.IMGX_PROJECT_ROOT)
     return process.env.IMGX_PROJECT_ROOT;
+  if (_mcpRoot)
+    return _mcpRoot;
   if (_cachedProjectRoot !== void 0)
     return _cachedProjectRoot;
   let dir = resolve(startDir ?? process.cwd());
@@ -39244,7 +39247,10 @@ function fallbackOutputDir(outputDir) {
     return resolveProjectPath(outputDir);
   const configured = resolveDefault("outputDir");
   if (configured)
-    return configured;
+    return resolveProjectPath(configured);
+  const projectRoot = findProjectRoot();
+  if (projectRoot)
+    return join2(projectRoot, ".imgx");
   return join2(homedir2(), "Pictures", "imgx");
 }
 function saveImage(image, outputPath, outputDir, sessionId) {
@@ -40213,7 +40219,7 @@ function runRedo() {
 }
 
 // build/cli/index.js
-var VERSION2 = "1.1.1";
+var VERSION2 = "1.2.0";
 var HELP = `imgx v${VERSION2} \u2014 AI image generation and editing for MCP-compatible AI agents
 
 Commands:

package/dist/mcp.bundle.js

@@ -6819,14 +6819,21 @@ __export(config_exports, {
   resolveApiKey: () => resolveApiKey,
   resolveDefault: () => resolveDefault,
   resolveProjectPath: () => resolveProjectPath,
-  saveConfig: () => saveConfig
+  saveConfig: () => saveConfig,
+  setProjectRoot: () => setProjectRoot
 });
 import { readFileSync, writeFileSync, mkdirSync, chmodSync, existsSync } from "node:fs";
 import { dirname, isAbsolute, join, resolve } from "node:path";
 import { homedir, platform } from "node:os";
+function setProjectRoot(root) {
+  _mcpRoot = root;
+  _cachedProjectRoot = void 0;
+}
 function findProjectRoot(startDir) {
   if (process.env.IMGX_PROJECT_ROOT)
     return process.env.IMGX_PROJECT_ROOT;
+  if (_mcpRoot)
+    return _mcpRoot;
   if (_cachedProjectRoot !== void 0)
     return _cachedProjectRoot;
   let dir = resolve(startDir ?? process.cwd());
@@ -6845,6 +6852,7 @@ function findProjectRoot(startDir) {
 }
 function resetProjectRootCache() {
   _cachedProjectRoot = void 0;
+  _mcpRoot = null;
 }
 function resolveProjectPath(relativePath) {
   if (isAbsolute(relativePath))
@@ -6919,10 +6927,11 @@ function resolveDefault(key) {
 function getConfigPath() {
   return configPath();
 }
-var _cachedProjectRoot;
+var _cachedProjectRoot, _mcpRoot;
 var init_config = __esm({
   "build/core/config.js"() {
     "use strict";
+    _mcpRoot = null;
   }
 });
 
@@ -69531,7 +69540,10 @@ function fallbackOutputDir(outputDir) {
     return resolveProjectPath(outputDir);
   const configured = resolveDefault("outputDir");
   if (configured)
-    return configured;
+    return resolveProjectPath(configured);
+  const projectRoot = findProjectRoot();
+  if (projectRoot)
+    return join2(projectRoot, ".imgx");
   return join2(homedir2(), "Pictures", "imgx");
 }
 function saveImage(image, outputPath, outputDir, sessionId) {
@@ -69871,7 +69883,9 @@ function initOpenAI() {
 
 // build/mcp/server.js
 init_history();
+init_config();
 import { randomUUID as randomUUID3 } from "node:crypto";
+import { fileURLToPath } from "node:url";
 function buildImageContent(images, paths, extra) {
   const content = [];
   for (const img of images) {
@@ -69882,7 +69896,7 @@ function buildImageContent(images, paths, extra) {
 }
 var server = new McpServer({
   name: "imgx",
-  version: "1.1.1"
+  version: "1.2.0"
 });
 initGemini();
 initOpenAI();
@@ -70174,9 +70188,27 @@ server.tool("list_providers", "List available image providers and their capabili
     content: [{ type: "text", text: JSON.stringify({ providers: data }) }]
   };
 });
+function fileUriToPath(uri) {
+  try {
+    return fileURLToPath(uri);
+  } catch {
+    const stripped = uri.replace(/^file:\/\/\//, "");
+    return decodeURIComponent(stripped);
+  }
+}
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
+  try {
+    const result = await server.server.listRoots();
+    if (result.roots.length > 0) {
+      const rootUri = result.roots[0].uri;
+      if (rootUri.startsWith("file://")) {
+        setProjectRoot(fileUriToPath(rootUri));
+      }
+    }
+  } catch {
+  }
 }
 main().catch((err) => {
   console.error("MCP server error:", err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "imgx-mcp",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "mcpName": "io.github.somacoffeekyoto/imgx",
   "description": "AI image generation and editing for Claude Code, Codex CLI, and MCP-compatible AI agents",
   "type": "module",