atelier-mcp 0.2.0 → 0.3.0

package/README.md

@@ -1,17 +1,27 @@
 # atelier-mcp
 
-An AI architect that lives inside your MCP client (Claude Code, Claude Desktop, …) — for **Vietnamese tube houses**: floor plans with proper TCVN symbols, a live two-way browser editor (drag walls, type exact mm), furnished 3D walkthrough, sun study, rough cost estimate, and a numbered A3 PDF / DXF / glTF / IFC documentation set.
+An AI architect that plugs into **any MCP client** — Claude Code, OpenAI Codex CLI, Gemini CLI, Claude Desktop, Cursor… — for **Vietnamese tube houses**: floor plans with proper TCVN symbols, a live two-way browser editor (drag walls, type exact mm), furnished 3D walkthrough, sun study, rough cost estimate, and a numbered A3 PDF / DXF / glTF / IFC documentation set.
 
 Bản gốc tiếng Việt + toàn bộ tài liệu thiết kế: [github.com/lebac-svg/Atelier](https://github.com/lebac-svg/Atelier)
 
 ## Install
 
+Atelier is a standard MCP server, not tied to Claude. Stand in your house folder (one folder = one house — the model lives there) and run ONE command — it detects every MCP client on your machine (Claude Code, Codex CLI, Gemini CLI, Claude Desktop, Cursor) and registers with each:
+
+```bash
+cd my-house
+npx -y atelier-mcp setup
+```
+
+Or register manually with your client of choice:
+
 ```bash
-cd my-house            # one folder = one house (the model lives here)
-claude mcp add atelier -- npx -y atelier-mcp
+claude mcp add atelier -- npx -y atelier-mcp   # Claude Code
+codex mcp add atelier -- npx -y atelier-mcp    # OpenAI Codex CLI
+gemini mcp add atelier npx -y atelier-mcp      # Gemini CLI
 ```
 
-That's it. Open Claude Code in that folder and say *"design me a 4×16m tube house, 2 floors, 3 bedrooms"*.
+That's it. Open your agent in that folder and say *"design me a 4×16m tube house, 2 floors, 3 bedrooms"*. Works best with a model that reads Vietnamese well (tool descriptions are Vietnamese-first) and a client that shows images from tool results — the agent inspects its own drawings.
 
 Optional, for PNG/PDF export (first time only):
 
@@ -19,7 +29,7 @@ Optional, for PNG/PDF export (first time only):
 npx playwright install chromium
 ```
 
-Claude Desktop — add to `claude_desktop_config.json`:
+GUI clients (Claude Desktop, Cursor, …) have no working folder — set `ATELIER_DIR`, e.g. in `claude_desktop_config.json`:
 
 ```json
 {

package/dist/main.mjs

@@ -6960,8 +6960,8 @@ var require_utils = __commonJS({
       }
       return ind;
     }
-    function removeDotSegments(path7) {
-      let input = path7;
+    function removeDotSegments(path8) {
+      let input = path8;
       const output = [];
       let nextSlash = -1;
       let len2 = 0;
@@ -7213,8 +7213,8 @@ var require_schemes = __commonJS({
         wsComponent.secure = void 0;
       }
       if (wsComponent.resourceName) {
-        const [path7, query] = wsComponent.resourceName.split("?");
-        wsComponent.path = path7 && path7 !== "/" ? path7 : void 0;
+        const [path8, query] = wsComponent.resourceName.split("?");
+        wsComponent.path = path8 && path8 !== "/" ? path8 : void 0;
         wsComponent.query = query;
         wsComponent.resourceName = void 0;
       }
@@ -10659,9 +10659,101 @@ var init_pdf = __esm({
   }
 });
 
-// src/main.ts
-import { mkdirSync as mkdirSync5 } from "node:fs";
+// src/setup.ts
+var setup_exports = {};
+__export(setup_exports, {
+  cursorConfigPath: () => cursorConfigPath,
+  desktopConfigPath: () => desktopConfigPath,
+  runSetup: () => runSetup,
+  upsertMcpJson: () => upsertMcpJson
+});
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync4, mkdirSync as mkdirSync5, readFileSync as readFileSync6, writeFileSync as writeFileSync5 } from "node:fs";
 import path6 from "node:path";
+function upsertMcpJson(existingText, houseDir) {
+  let cfg = {};
+  if (existingText != null && existingText.trim() !== "") {
+    cfg = JSON.parse(existingText);
+  }
+  const servers = cfg.mcpServers ?? {};
+  servers.atelier = {
+    command: SERVER_ARGS[0],
+    args: SERVER_ARGS.slice(1),
+    env: { ATELIER_DIR: houseDir }
+  };
+  cfg.mcpServers = servers;
+  return JSON.stringify(cfg, null, 2) + "\n";
+}
+function desktopConfigPath(platform, env) {
+  const dir = platform === "win32" ? env.APPDATA && path6.join(env.APPDATA, "Claude") : platform === "darwin" ? env.HOME && path6.join(env.HOME, "Library", "Application Support", "Claude") : env.HOME && path6.join(env.HOME, ".config", "Claude");
+  if (!dir || !existsSync4(dir)) return null;
+  return path6.join(dir, "claude_desktop_config.json");
+}
+function cursorConfigPath(env) {
+  const home = env.HOME ?? env.USERPROFILE;
+  if (!home) return null;
+  const dir = path6.join(home, ".cursor");
+  return existsSync4(dir) ? path6.join(dir, "mcp.json") : null;
+}
+function tryCli(bin, args) {
+  const probe = spawnSync(bin, ["--version"], { shell: true, stdio: "ignore", timeout: 2e4 });
+  if (probe.status !== 0) return { found: false, ok: false, out: "" };
+  const r = spawnSync(bin, args, { shell: true, encoding: "utf8", timeout: 6e4 });
+  const out = `${r.stdout ?? ""}${r.stderr ?? ""}`.trim().split("\n").at(-1) ?? "";
+  return { found: true, ok: r.status === 0, out };
+}
+function runSetup(houseDir, io = { log: (s) => console.error(s) }) {
+  const results = [];
+  for (const c of CLI_CLIENTS) {
+    const r = tryCli(c.bin, c.addArgs);
+    if (!r.found) {
+      results.push({ client: c.name, status: "not found", detail: `'${c.bin}' is not on PATH` });
+    } else if (r.ok) {
+      results.push({ client: c.name, status: "registered", detail: r.out || `${c.bin} ${c.addArgs.join(" ")}` });
+    } else {
+      results.push({ client: c.name, status: "error", detail: r.out || "command failed" });
+    }
+  }
+  const jsonTargets = [
+    { name: "Claude Desktop", file: desktopConfigPath(process.platform, process.env) },
+    { name: "Cursor", file: cursorConfigPath(process.env) }
+  ];
+  for (const t of jsonTargets) {
+    if (!t.file) {
+      results.push({ client: t.name, status: "not found", detail: "app config folder not present" });
+      continue;
+    }
+    try {
+      const before = existsSync4(t.file) ? readFileSync6(t.file, "utf8") : null;
+      mkdirSync5(path6.dirname(t.file), { recursive: true });
+      writeFileSync5(t.file, upsertMcpJson(before, houseDir), "utf8");
+      results.push({ client: t.name, status: "registered", detail: `${t.file} (ATELIER_DIR=${houseDir}) \u2014 restart the app` });
+    } catch (e) {
+      results.push({ client: t.name, status: "error", detail: `${t.file}: ${e instanceof Error ? e.message : String(e)} \u2014 edit manually per README` });
+    }
+  }
+  const icon = { registered: "\u2714", "not found": "\xB7", error: "\u2718" };
+  io.log(`atelier-mcp setup \u2014 house folder: ${houseDir}`);
+  for (const r of results) io.log(`${icon[r.status]} ${r.client}: ${r.status}${r.detail ? ` \u2014 ${r.detail}` : ""}`);
+  const n = results.filter((r) => r.status === "registered").length;
+  io.log(n > 0 ? `Done: registered with ${n} client(s). Open your agent here and say "design me a tube house".` : `No MCP client found. Install one (Claude Code, Codex CLI, Gemini CLI, Claude Desktop, Cursor) or register manually \u2014 see https://github.com/lebac-svg/Atelier#install-30-seconds`);
+  return results;
+}
+var SERVER_ARGS, CLI_CLIENTS;
+var init_setup = __esm({
+  "src/setup.ts"() {
+    SERVER_ARGS = ["npx", "-y", "atelier-mcp"];
+    CLI_CLIENTS = [
+      { name: "Claude Code", bin: "claude", addArgs: ["mcp", "add", "atelier", "--", ...SERVER_ARGS] },
+      { name: "Codex CLI", bin: "codex", addArgs: ["mcp", "add", "atelier", "--", ...SERVER_ARGS] },
+      { name: "Gemini CLI", bin: "gemini", addArgs: ["mcp", "add", "atelier", ...SERVER_ARGS] }
+    ];
+  }
+});
+
+// src/main.ts
+import { mkdirSync as mkdirSync6 } from "node:fs";
+import path7 from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 
 // ../../node_modules/.pnpm/@modelcontextprotocol+sdk@1.29.0_zod@3.25.76/node_modules/@modelcontextprotocol/sdk/dist/esm/server/stdio.js
@@ -10863,10 +10955,10 @@ function assignProp(target, prop, value) {
     configurable: true
   });
 }
-function getElementAtPath(obj, path7) {
-  if (!path7)
+function getElementAtPath(obj, path8) {
+  if (!path8)
     return obj;
-  return path7.reduce((acc, key) => acc?.[key], obj);
+  return path8.reduce((acc, key) => acc?.[key], obj);
 }
 function promiseAllObject(promisesObj) {
   const keys = Object.keys(promisesObj);
@@ -11186,11 +11278,11 @@ function aborted(x, startIndex = 0) {
   }
   return false;
 }
-function prefixIssues(path7, issues) {
+function prefixIssues(path8, issues) {
   return issues.map((iss) => {
     var _a;
     (_a = iss).path ?? (_a.path = []);
-    iss.path.unshift(path7);
+    iss.path.unshift(path8);
     return iss;
   });
 }
@@ -23021,26 +23113,26 @@ var handleParsingNestedValues = (form, key, value) => {
 };
 
 // ../../node_modules/.pnpm/hono@4.12.29/node_modules/hono/dist/utils/url.js
-var splitPath = (path7) => {
-  const paths = path7.split("/");
+var splitPath = (path8) => {
+  const paths = path8.split("/");
   if (paths[0] === "") {
     paths.shift();
   }
   return paths;
 };
 var splitRoutingPath = (routePath) => {
-  const { groups, path: path7 } = extractGroupsFromPath(routePath);
-  const paths = splitPath(path7);
+  const { groups, path: path8 } = extractGroupsFromPath(routePath);
+  const paths = splitPath(path8);
   return replaceGroupMarks(paths, groups);
 };
-var extractGroupsFromPath = (path7) => {
+var extractGroupsFromPath = (path8) => {
   const groups = [];
-  path7 = path7.replace(/\{[^}]+\}/g, (match2, index) => {
+  path8 = path8.replace(/\{[^}]+\}/g, (match2, index) => {
     const mark = `@${index}`;
     groups.push([mark, match2]);
     return mark;
   });
-  return { groups, path: path7 };
+  return { groups, path: path8 };
 };
 var replaceGroupMarks = (paths, groups) => {
   for (let i = groups.length - 1; i >= 0; i--) {
@@ -23097,8 +23189,8 @@ var getPath = (request) => {
       const queryIndex = url.indexOf("?", i);
       const hashIndex = url.indexOf("#", i);
       const end = queryIndex === -1 ? hashIndex === -1 ? void 0 : hashIndex : hashIndex === -1 ? queryIndex : Math.min(queryIndex, hashIndex);
-      const path7 = url.slice(start, end);
-      return tryDecodeURI(path7.includes("%25") ? path7.replace(/%25/g, "%2525") : path7);
+      const path8 = url.slice(start, end);
+      return tryDecodeURI(path8.includes("%25") ? path8.replace(/%25/g, "%2525") : path8);
     } else if (charCode === 63 || charCode === 35) {
       break;
     }
@@ -23115,11 +23207,11 @@ var mergePath = (base, sub2, ...rest) => {
   }
   return `${base?.[0] === "/" ? "" : "/"}${base}${sub2 === "/" ? "" : `${base?.at(-1) === "/" ? "" : "/"}${sub2?.[0] === "/" ? sub2.slice(1) : sub2}`}`;
 };
-var checkOptionalParameter = (path7) => {
-  if (path7.charCodeAt(path7.length - 1) !== 63 || !path7.includes(":")) {
+var checkOptionalParameter = (path8) => {
+  if (path8.charCodeAt(path8.length - 1) !== 63 || !path8.includes(":")) {
     return null;
   }
-  const segments = path7.split("/");
+  const segments = path8.split("/");
   const results = [];
   let basePath = "";
   segments.forEach((segment) => {
@@ -23260,9 +23352,9 @@ var HonoRequest = class {
    */
   path;
   bodyCache = {};
-  constructor(request, path7 = "/", matchResult = [[]]) {
+  constructor(request, path8 = "/", matchResult = [[]]) {
     this.raw = request;
-    this.path = path7;
+    this.path = path8;
     this.#matchResult = matchResult;
     this.#validatedData = {};
   }
@@ -24014,8 +24106,8 @@ var Hono = class _Hono {
         return this;
       };
     });
-    this.on = (method, path7, ...handlers) => {
-      for (const p of [path7].flat()) {
+    this.on = (method, path8, ...handlers) => {
+      for (const p of [path8].flat()) {
         this.#path = p;
         for (const m of [method].flat()) {
           handlers.map((handler) => {
@@ -24072,8 +24164,8 @@ var Hono = class _Hono {
    * app.route("/api", app2) // GET /api/user
    * ```
    */
-  route(path7, app) {
-    const subApp = this.basePath(path7);
+  route(path8, app) {
+    const subApp = this.basePath(path8);
     app.routes.map((r) => {
       let handler;
       if (app.errorHandler === errorHandler) {
@@ -24099,9 +24191,9 @@ var Hono = class _Hono {
    * const api = new Hono().basePath('/api')
    * ```
    */
-  basePath(path7) {
+  basePath(path8) {
     const subApp = this.#clone();
-    subApp._basePath = mergePath(this._basePath, path7);
+    subApp._basePath = mergePath(this._basePath, path8);
     return subApp;
   }
   /**
@@ -24175,7 +24267,7 @@ var Hono = class _Hono {
    * })
    * ```
    */
-  mount(path7, applicationHandler, options) {
+  mount(path8, applicationHandler, options) {
     let replaceRequest;
     let optionHandler;
     if (options) {
@@ -24202,7 +24294,7 @@ var Hono = class _Hono {
       return [c.env, executionContext];
     };
     replaceRequest ||= (() => {
-      const mergedPath = mergePath(this._basePath, path7);
+      const mergedPath = mergePath(this._basePath, path8);
       const pathPrefixLength = mergedPath === "/" ? 0 : mergedPath.length;
       return (request) => {
         const url = new URL(request.url);
@@ -24217,19 +24309,19 @@ var Hono = class _Hono {
       }
       await next();
     };
-    this.#addRoute(METHOD_NAME_ALL, mergePath(path7, "*"), handler);
+    this.#addRoute(METHOD_NAME_ALL, mergePath(path8, "*"), handler);
     return this;
   }
-  #addRoute(method, path7, handler, baseRoutePath) {
+  #addRoute(method, path8, handler, baseRoutePath) {
     method = method.toUpperCase();
-    path7 = mergePath(this._basePath, path7);
+    path8 = mergePath(this._basePath, path8);
     const r = {
       basePath: baseRoutePath !== void 0 ? mergePath(this._basePath, baseRoutePath) : this._basePath,
-      path: path7,
+      path: path8,
       method,
       handler
     };
-    this.router.add(method, path7, [handler, r]);
+    this.router.add(method, path8, [handler, r]);
     this.routes.push(r);
   }
   #handleError(err, c) {
@@ -24242,10 +24334,10 @@ var Hono = class _Hono {
     if (method === "HEAD") {
       return (async () => new Response(null, await this.#dispatch(request, executionCtx, env, "GET")))();
     }
-    const path7 = this.getPath(request, { env });
-    const matchResult = this.router.match(method, path7);
+    const path8 = this.getPath(request, { env });
+    const matchResult = this.router.match(method, path8);
     const c = new Context(request, {
-      path: path7,
+      path: path8,
       matchResult,
       env,
       executionCtx,
@@ -24345,7 +24437,7 @@ var Hono = class _Hono {
 
 // ../../node_modules/.pnpm/hono@4.12.29/node_modules/hono/dist/router/reg-exp-router/matcher.js
 var emptyParam = [];
-function match(method, path7) {
+function match(method, path8) {
   const matchers = this.buildAllMatchers();
   const match2 = ((method2, path22) => {
     const matcher = matchers[method2] || matchers[METHOD_NAME_ALL];
@@ -24361,7 +24453,7 @@ function match(method, path7) {
     return [matcher[1][index], match3];
   });
   this.match = match2;
-  return match2(method, path7);
+  return match2(method, path8);
 }
 
 // ../../node_modules/.pnpm/hono@4.12.29/node_modules/hono/dist/router/reg-exp-router/node.js
@@ -24476,12 +24568,12 @@ var Node = class _Node {
 var Trie = class {
   #context = { varIndex: 0 };
   #root = new Node();
-  insert(path7, index, pathErrorCheckOnly) {
+  insert(path8, index, pathErrorCheckOnly) {
     const paramAssoc = [];
     const groups = [];
     for (let i = 0; ; ) {
       let replaced = false;
-      path7 = path7.replace(/\{[^}]+\}/g, (m) => {
+      path8 = path8.replace(/\{[^}]+\}/g, (m) => {
         const mark = `@\\${i}`;
         groups[i] = [mark, m];
         i++;
@@ -24492,7 +24584,7 @@ var Trie = class {
         break;
       }
     }
-    const tokens = path7.match(/(?::[^\/]+)|(?:\/\*$)|./g) || [];
+    const tokens = path8.match(/(?::[^\/]+)|(?:\/\*$)|./g) || [];
     for (let i = groups.length - 1; i >= 0; i--) {
       const [mark] = groups[i];
       for (let j = tokens.length - 1; j >= 0; j--) {
@@ -24531,9 +24623,9 @@ var Trie = class {
 // ../../node_modules/.pnpm/hono@4.12.29/node_modules/hono/dist/router/reg-exp-router/router.js
 var nullMatcher = [/^$/, [], /* @__PURE__ */ Object.create(null)];
 var wildcardRegExpCache = /* @__PURE__ */ Object.create(null);
-function buildWildcardRegExp(path7) {
-  return wildcardRegExpCache[path7] ??= new RegExp(
-    path7 === "*" ? "" : `^${path7.replace(
+function buildWildcardRegExp(path8) {
+  return wildcardRegExpCache[path8] ??= new RegExp(
+    path8 === "*" ? "" : `^${path8.replace(
       /\/\*$|([.\\+*[^\]$()])/g,
       (_, metaChar) => metaChar ? `\\${metaChar}` : "(?:|/.*)"
     )}$`
@@ -24555,17 +24647,17 @@ function buildMatcherFromPreprocessedRoutes(routes) {
   );
   const staticMap = /* @__PURE__ */ Object.create(null);
   for (let i = 0, j = -1, len2 = routesWithStaticPathFlag.length; i < len2; i++) {
-    const [pathErrorCheckOnly, path7, handlers] = routesWithStaticPathFlag[i];
+    const [pathErrorCheckOnly, path8, handlers] = routesWithStaticPathFlag[i];
     if (pathErrorCheckOnly) {
-      staticMap[path7] = [handlers.map(([h]) => [h, /* @__PURE__ */ Object.create(null)]), emptyParam];
+      staticMap[path8] = [handlers.map(([h]) => [h, /* @__PURE__ */ Object.create(null)]), emptyParam];
     } else {
       j++;
     }
     let paramAssoc;
     try {
-      paramAssoc = trie.insert(path7, j, pathErrorCheckOnly);
+      paramAssoc = trie.insert(path8, j, pathErrorCheckOnly);
     } catch (e) {
-      throw e === PATH_ERROR ? new UnsupportedPathError(path7) : e;
+      throw e === PATH_ERROR ? new UnsupportedPathError(path8) : e;
     }
     if (pathErrorCheckOnly) {
       continue;
@@ -24599,12 +24691,12 @@ function buildMatcherFromPreprocessedRoutes(routes) {
   }
   return [regexp, handlerMap, staticMap];
 }
-function findMiddleware(middleware, path7) {
+function findMiddleware(middleware, path8) {
   if (!middleware) {
     return void 0;
   }
   for (const k of Object.keys(middleware).sort((a, b) => b.length - a.length)) {
-    if (buildWildcardRegExp(k).test(path7)) {
+    if (buildWildcardRegExp(k).test(path8)) {
       return [...middleware[k]];
     }
   }
@@ -24618,7 +24710,7 @@ var RegExpRouter = class {
     this.#middleware = { [METHOD_NAME_ALL]: /* @__PURE__ */ Object.create(null) };
     this.#routes = { [METHOD_NAME_ALL]: /* @__PURE__ */ Object.create(null) };
   }
-  add(method, path7, handler) {
+  add(method, path8, handler) {
     const middleware = this.#middleware;
     const routes = this.#routes;
     if (!middleware || !routes) {
@@ -24633,18 +24725,18 @@ var RegExpRouter = class {
         });
       });
     }
-    if (path7 === "/*") {
-      path7 = "*";
+    if (path8 === "/*") {
+      path8 = "*";
     }
-    const paramCount = (path7.match(/\/:/g) || []).length;
-    if (/\*$/.test(path7)) {
-      const re = buildWildcardRegExp(path7);
+    const paramCount = (path8.match(/\/:/g) || []).length;
+    if (/\*$/.test(path8)) {
+      const re = buildWildcardRegExp(path8);
       if (method === METHOD_NAME_ALL) {
         Object.keys(middleware).forEach((m) => {
-          middleware[m][path7] ||= findMiddleware(middleware[m], path7) || findMiddleware(middleware[METHOD_NAME_ALL], path7) || [];
+          middleware[m][path8] ||= findMiddleware(middleware[m], path8) || findMiddleware(middleware[METHOD_NAME_ALL], path8) || [];
         });
       } else {
-        middleware[method][path7] ||= findMiddleware(middleware[method], path7) || findMiddleware(middleware[METHOD_NAME_ALL], path7) || [];
+        middleware[method][path8] ||= findMiddleware(middleware[method], path8) || findMiddleware(middleware[METHOD_NAME_ALL], path8) || [];
       }
       Object.keys(middleware).forEach((m) => {
         if (method === METHOD_NAME_ALL || method === m) {
@@ -24662,7 +24754,7 @@ var RegExpRouter = class {
       });
       return;
     }
-    const paths = checkOptionalParameter(path7) || [path7];
+    const paths = checkOptionalParameter(path8) || [path8];
     for (let i = 0, len2 = paths.length; i < len2; i++) {
       const path22 = paths[i];
       Object.keys(routes).forEach((m) => {
@@ -24689,13 +24781,13 @@ var RegExpRouter = class {
     const routes = [];
     let hasOwnRoute = method === METHOD_NAME_ALL;
     [this.#middleware, this.#routes].forEach((r) => {
-      const ownRoute = r[method] ? Object.keys(r[method]).map((path7) => [path7, r[method][path7]]) : [];
+      const ownRoute = r[method] ? Object.keys(r[method]).map((path8) => [path8, r[method][path8]]) : [];
       if (ownRoute.length !== 0) {
         hasOwnRoute ||= true;
         routes.push(...ownRoute);
       } else if (method !== METHOD_NAME_ALL) {
         routes.push(
-          ...Object.keys(r[METHOD_NAME_ALL]).map((path7) => [path7, r[METHOD_NAME_ALL][path7]])
+          ...Object.keys(r[METHOD_NAME_ALL]).map((path8) => [path8, r[METHOD_NAME_ALL][path8]])
         );
       }
     });
@@ -24715,13 +24807,13 @@ var SmartRouter = class {
   constructor(init) {
     this.#routers = init.routers;
   }
-  add(method, path7, handler) {
+  add(method, path8, handler) {
     if (!this.#routes) {
       throw new Error(MESSAGE_MATCHER_IS_ALREADY_BUILT);
     }
-    this.#routes.push([method, path7, handler]);
+    this.#routes.push([method, path8, handler]);
   }
-  match(method, path7) {
+  match(method, path8) {
     if (!this.#routes) {
       throw new Error("Fatal error");
     }
@@ -24736,7 +24828,7 @@ var SmartRouter = class {
         for (let i2 = 0, len22 = routes.length; i2 < len22; i2++) {
           router.add(...routes[i2]);
         }
-        res = router.match(method, path7);
+        res = router.match(method, path8);
       } catch (e) {
         if (e instanceof UnsupportedPathError) {
           continue;
@@ -24786,10 +24878,10 @@ var Node2 = class _Node2 {
     }
     this.#patterns = [];
   }
-  insert(method, path7, handler) {
+  insert(method, path8, handler) {
     this.#order = ++this.#order;
     let curNode = this;
-    const parts = splitRoutingPath(path7);
+    const parts = splitRoutingPath(path8);
     const possibleKeys = [];
     for (let i = 0, len2 = parts.length; i < len2; i++) {
       const p = parts[i];
@@ -24838,12 +24930,12 @@ var Node2 = class _Node2 {
       }
     }
   }
-  search(method, path7) {
+  search(method, path8) {
     const handlerSets = [];
     this.#params = emptyParams;
     const curNode = this;
     let curNodes = [curNode];
-    const parts = splitPath(path7);
+    const parts = splitPath(path8);
     const curNodesQueue = [];
     const len2 = parts.length;
     let partOffsets = null;
@@ -24885,13 +24977,13 @@ var Node2 = class _Node2 {
           if (matcher instanceof RegExp) {
             if (partOffsets === null) {
               partOffsets = new Array(len2);
-              let offset = path7[0] === "/" ? 1 : 0;
+              let offset = path8[0] === "/" ? 1 : 0;
               for (let p = 0; p < len2; p++) {
                 partOffsets[p] = offset;
                 offset += parts[p].length + 1;
               }
             }
-            const restPathString = path7.substring(partOffsets[i]);
+            const restPathString = path8.substring(partOffsets[i]);
             const m = matcher.exec(restPathString);
             if (m) {
               params[name] = m[0];
@@ -24953,18 +25045,18 @@ var TrieRouter = class {
   constructor() {
     this.#node = new Node2();
   }
-  add(method, path7, handler) {
-    const results = checkOptionalParameter(path7);
+  add(method, path8, handler) {
+    const results = checkOptionalParameter(path8);
     if (results) {
       for (let i = 0, len2 = results.length; i < len2; i++) {
         this.#node.insert(method, results[i], handler);
       }
       return;
     }
-    this.#node.insert(method, path7, handler);
+    this.#node.insert(method, path8, handler);
   }
-  match(method, path7) {
-    return this.#node.search(method, path7);
+  match(method, path8) {
+    return this.#node.search(method, path8);
   }
 };
 
@@ -26585,8 +26677,8 @@ function getErrorMap() {
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/helpers/parseUtil.js
 var makeIssue = (params) => {
-  const { data, path: path7, errorMaps, issueData } = params;
-  const fullPath = [...path7, ...issueData.path || []];
+  const { data, path: path8, errorMaps, issueData } = params;
+  const fullPath = [...path8, ...issueData.path || []];
   const fullIssue = {
     ...issueData,
     path: fullPath
@@ -26702,11 +26794,11 @@ var errorUtil;
 
 // ../../node_modules/.pnpm/zod@3.25.76/node_modules/zod/v3/types.js
 var ParseInputLazyPath = class {
-  constructor(parent, value, path7, key) {
+  constructor(parent, value, path8, key) {
     this._cachedPath = [];
     this.parent = parent;
     this.data = value;
-    this._path = path7;
+    this._path = path8;
     this._key = key;
   }
   get path() {
@@ -35657,10 +35749,15 @@ function queryModel(p, select, computed) {
 }
 
 // src/main.ts
-var pkgRoot = path6.resolve(path6.dirname(fileURLToPath3(import.meta.url)), "..");
-process.env.ATELIER_FONT_DIR ??= path6.join(pkgRoot, "assets", "fonts");
-var baseDir = path6.resolve(process.env.ATELIER_DIR ?? ".");
-mkdirSync5(baseDir, { recursive: true });
+if (process.argv[2] === "setup") {
+  const { runSetup: runSetup2 } = await Promise.resolve().then(() => (init_setup(), setup_exports));
+  const results = runSetup2(path7.resolve(process.env.ATELIER_DIR ?? "."));
+  process.exit(results.some((r) => r.status === "error") ? 1 : 0);
+}
+var pkgRoot = path7.resolve(path7.dirname(fileURLToPath3(import.meta.url)), "..");
+process.env.ATELIER_FONT_DIR ??= path7.join(pkgRoot, "assets", "fonts");
+var baseDir = path7.resolve(process.env.ATELIER_DIR ?? ".");
+mkdirSync6(baseDir, { recursive: true });
 var store = new ProjectStore(baseDir);
 try {
   store.openProject();
@@ -35668,7 +35765,7 @@ try {
 } catch {
   console.error(`[atelier] ch\u01B0a c\xF3 d\u1EF1 \xE1n t\u1EA1i ${baseDir} \u2014 ch\u1EDD project_new/project_open`);
 }
-var live = new LiveServer(store, { webDist: process.env.ATELIER_WEB_DIST ?? path6.join(pkgRoot, "web") });
+var live = new LiveServer(store, { webDist: process.env.ATELIER_WEB_DIST ?? path7.join(pkgRoot, "web") });
 var server = createAtelierServer(store, live);
 await server.connect(new StdioServerTransport());
 console.error("[atelier] MCP server s\u1EB5n s\xE0ng (stdio)");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "atelier-mcp",
-  "version": "0.2.0",
-  "description": "AI architect MCP server for Vietnamese tube houses — TCVN-standard plans, live two-way browser editor, furnished 3D walkthrough, PDF/DXF/IFC export. Run it inside your house-project folder from Claude Code, Claude Desktop, or any MCP client.",
+  "version": "0.3.0",
+  "description": "AI architect MCP server for Vietnamese tube houses — TCVN-standard plans, live two-way browser editor, furnished 3D walkthrough, PDF/DXF/IFC export. Works with any MCP client: Claude Code, Codex CLI, Gemini CLI, Claude Desktop, Cursor. Run it inside your house-project folder.",
   "type": "module",
   "bin": {
     "atelier-mcp": "bin/atelier-mcp.mjs"