@husar.ai/cli 0.2.11 → 0.2.13

package/MCP_SERVER.md

@@ -0,0 +1,84 @@
+# MCP Server Setup (Cursor + Codex)
+
+This guide shows how to register the Husar MCP server so your AI tools can call the CLI commands (e.g., `husar.ai copy ...`) via the `cms_parse_file` tool.
+
+The MCP server is built into the CLI. Run it as `husar.ai mcp`.
+
+## Prerequisites
+
+- Install `@husar.ai/cli` so `husar.ai` is on your PATH.
+- Ensure your workspace (project root) contains `husar.json` with:
+  - `host`: Husar CMS base URL
+  - `adminToken`: Husar admin token (required for copy/upsert)
+  - Use `husar.ai generate` or edit `husar.json` directly to set these.
+
+No environment variables are required. MCP reads config like the CLI and auto-detects the workspace root.
+
+## Cursor: `mcp.json`
+
+Create or edit `~/.cursor/mcp.json` and add the Husar server entry.
+
+```json
+{
+  "mcpServers": {
+    "husar": {
+      "command": "husar.ai",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+Notes:
+
+- Ensure `husar.ai` is on PATH (global install) or use an absolute path to the binary.
+
+## Codex: `config.toml`
+
+Create or edit `~/.config/codex/config.toml` and add a server entry.
+
+```toml
+[mcp_servers.husar]
+command = "husar.ai"
+args = ["mcp"]
+```
+
+Notes:
+
+- No env vars are required. The server detects the workspace root and reads `husar.json` like the CLI.
+
+## Available Tools
+
+- `cms_parse_file`:
+  - Purpose: Parse a CMS file into a shape or model and upsert via CLI.
+  - Inputs:
+    - `path`: Absolute path or path relative to the detected workspace root.
+    - `type`: Optional, `"model" | "shape"` (default `"shape"`).
+    - `name`: Optional string; if omitted, derived from filename (lowercased).
+  - Output: JSON stringified status or error details.
+  - Notes: This maps to the `husar_copy` implementation; kept for compatibility.
+
+- `husar_copy`:
+  - Purpose: Same as `cms_parse_file` (alias of the CLI `copy` command).
+  - Inputs: Same as `cms_parse_file`.
+  - Auth: Reads `host` and `adminToken` from `husar.json` at the workspace root (same as CLI).
+  - Example arguments:
+    - `path`: `packages/playground/src/pages/examples/ContactForm.tsx`
+    - `type`: `shape`
+    - `name`: `examples_contactform`
+
+- `husar_generate`:
+  - Purpose: Generate CMS scaffolding (Zeus client, host helpers, SSR + React helpers) into `cms/`.
+  - Inputs:
+    - `folderPath`: Optional target directory relative to the detected workspace root (defaults to `"."`). The `cms/` folder is created/rewritten inside this path.
+  - Host config: Uses `host` from `husar.json` at the workspace root.
+  - Output: JSON with `{ "status": "ok", "folder": "<ABS_PATH_TO_cms>" }` or error details.
+  - Files written:
+    - `cms/zeus/index.ts`, `cms/zeus/const.ts`
+    - `cms/host.ts`, `cms/ssr.ts`, `cms/react.ts`
+
+## Troubleshooting
+
+- CLI not found: Ensure `@husar.ai/cli` is installed globally or that `husar.ai` is on PATH.
+- Config errors: Make sure `husar.json` at your workspace root contains `host` and `adminToken`.
+- Workspace detection: The server walks up from its current working directory to find a `package.json` with `workspaces`. Launch it from within your project.

package/dist/cli.js

@@ -1,10 +1,9 @@
 #!/usr/bin/env node
 import { Command } from 'commander';
-import fs, { constants } from 'node:fs/promises';
-import path from 'node:path';
-import { generateZeus } from '@husar.ai/ssr';
 import { ConfigMaker } from 'config-maker';
 import { parser } from './functions/parser.js';
+import { generateCms } from './functions/generate.js';
+import { startMcpServer } from './mcp.js';
 const config = new ConfigMaker('husar', { decoders: {} });
 const program = new Command();
 program.name('husar').description('HUSAR CLI for complete generation').version('0.0.5');
@@ -16,53 +15,12 @@ program
     const conf = config.get();
     const hostEnv = conf.hostEnvironmentVariable;
     const authenticationEnv = conf.authenticationEnvironmentVariable;
-    const cmsPath = path.join(folderPath, 'cms');
-    try {
-        await fs.access(cmsPath, constants.F_OK);
-        await fs.rm(cmsPath, { recursive: true, force: true });
-        console.log('Folder deleted.');
-    }
-    catch (err) {
-    }
-    const zeusPath = path.join(cmsPath, 'zeus');
-    await fs.mkdir(zeusPath, { recursive: true });
-    const zeusCode = await generateZeus(new URL('content/graphql', host).toString(), {
-        esModule: false,
-        env: 'browser',
+    await generateCms({
+        baseFolder: folderPath,
+        host,
+        hostEnvironmentVariable: hostEnv,
+        authenticationEnvironmentVariable: authenticationEnv,
     });
-    await fs.writeFile(path.join(zeusPath, 'index.ts'), zeusCode.index);
-    await fs.writeFile(path.join(zeusPath, 'const.ts'), zeusCode.const);
-    let hostFile = `import * as zeus from './zeus';\n`;
-    if (hostEnv) {
-        hostFile += `export const HUSAR_HOST = process.env.${hostEnv};\n`;
-    }
-    else {
-        hostFile += `export const HUSAR_HOST = 
-  process.env.HUSAR_HOST ||
-  process.env.NEXT_PUBLIC_HUSAR_HOST ||
-  process.env.VITE_HUSAR_HOST || '${host}';\n`;
-    }
-    hostFile += `
-export const getCmsHost = () => {
-  const husar_token = process.env.${authenticationEnv || 'HUSAR_API_KEY'};
-  const host = HUSAR_HOST ? new URL('content/graphql', HUSAR_HOST).toString() : zeus.HOST;
-  return [host, { ...(husar_token ? { headers: { husar_token } } : {}) }] as const;
-};
-`;
-    await fs.writeFile(path.join(cmsPath, 'host.ts'), hostFile);
-    await fs.writeFile(path.join(cmsPath, 'ssr.ts'), `import * as zeus from './zeus';
-import { husarClient } from '@husar.ai/ssr';
-import { getCmsHost } from './host';
-
-export const husar = husarClient<typeof zeus, zeus.ModelTypes>(zeus, ...getCmsHost());
-`);
-    await fs.writeFile(path.join(cmsPath, 'react.ts'), `import * as zeus from './zeus';
-import { HusarComponents } from '@husar.ai/render';
-import { getCmsHost } from './host';
-
-const { Shape, View, Model, Form } = HusarComponents<typeof zeus, zeus.ModelTypes>(getCmsHost());
-export { Shape, View, Model, Form };
-`);
 });
 program
     .command('copy <inputFile> <name>')
@@ -79,5 +37,12 @@ program
     const result = await parser(inputFile, { name, type: opts?.type }, { HUSAR_MCP_HOST: conf.host, HUSAR_MCP_ADMIN_TOKEN: conf.adminToken });
     console.log(result ? 'File parsed and upserted successfully.' : 'Failed to parse and upsert file.');
 });
+program
+    .command('mcp')
+    .description('Run the Husar MCP server over stdio')
+    .action(async () => {
+    await startMcpServer();
+    await new Promise(() => { });
+});
 program.parse(process.argv);
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,WAAW,CAM3B,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAE9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,OAAO;KACJ,OAAO,CAAC,uBAAuB,CAAC;KAChC,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,aAAqB,GAAG,EAAE,EAAE;IACzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC;IAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iCAAiC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;IAEpB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC/E,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpE,IAAI,QAAQ,GAAG,mCAAmC,CAAC;IACnD,IAAI,OAAO,EAAE,CAAC;QACZ,QAAQ,IAAI,yCAAyC,OAAO,KAAK,CAAC;IACpE,CAAC;SAAM,CAAC;QACN,QAAQ,IAAI;;;oCAGkB,IAAI,MAAM,CAAC;IAC3C,CAAC;IACD,QAAQ,IAAI;;oCAEoB,iBAAiB,IAAI,eAAe;;;;CAIvE,CAAC;IACE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5D,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5B;;;;;CAKL,CACI,CAAC;IACF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9B;;;;;;CAML,CACI,CAAC;AACJ,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,OAAO,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,SAAS,EACT,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAC1B,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,CAAC,UAAU,EAAE,CACtE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC;AACtG,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C,MAAM,MAAM,GAAG,IAAI,WAAW,CAM3B,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;AAE9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,mCAAmC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AAExF,OAAO;KACJ,OAAO,CAAC,uBAAuB,CAAC;KAChC,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,KAAK,EAAE,aAAqB,GAAG,EAAE,EAAE;IACzC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,MAAM,OAAO,GAAG,IAAI,CAAC,uBAAuB,CAAC;IAC7C,MAAM,iBAAiB,GAAG,IAAI,CAAC,iCAAiC,CAAC;IACjE,MAAM,WAAW,CAAC;QAChB,UAAU,EAAE,UAAU;QACtB,IAAI;QACJ,uBAAuB,EAAE,OAAO;QAChC,iCAAiC,EAAE,iBAAiB;KACrD,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,iEAAiE,CAAC;KAC9E,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,EAAE,OAAO,CAAC;KAChE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;IAC1B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,SAAS,EACT,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,EAC1B,EAAE,cAAc,EAAE,IAAI,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,CAAC,UAAU,EAAE,CACtE,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,wCAAwC,CAAC,CAAC,CAAC,kCAAkC,CAAC,CAAC;AACtG,CAAC,CAAC,CAAC;AAEL,OAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,qCAAqC,CAAC;KAClD,MAAM,CAAC,KAAK,IAAI,EAAE;IACjB,MAAM,cAAc,EAAE,CAAC;IAGvB,MAAM,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/functions/generate.d.ts

@@ -0,0 +1,7 @@
+export type GenerateCmsOptions = {
+    baseFolder: string;
+    host: string;
+    hostEnvironmentVariable?: string;
+    authenticationEnvironmentVariable?: string;
+};
+export declare const generateCms: (opts: GenerateCmsOptions) => Promise<string>;

package/dist/functions/generate.js

@@ -0,0 +1,46 @@
+import fs, { constants } from 'node:fs/promises';
+import path from 'node:path';
+import { generateZeus } from '@husar.ai/ssr';
+export const generateCms = async (opts) => {
+    const base = path.resolve(process.cwd(), opts.baseFolder || '.');
+    const cmsPath = path.join(base, 'cms');
+    try {
+        await fs.access(cmsPath, constants.F_OK);
+        await fs.rm(cmsPath, { recursive: true, force: true });
+    }
+    catch {
+    }
+    const zeusPath = path.join(cmsPath, 'zeus');
+    await fs.mkdir(zeusPath, { recursive: true });
+    const zeusCode = await generateZeus(new URL('content/graphql', opts.host).toString(), {
+        esModule: false,
+        env: 'browser',
+    });
+    await fs.writeFile(path.join(zeusPath, 'index.ts'), zeusCode.index);
+    await fs.writeFile(path.join(zeusPath, 'const.ts'), zeusCode.const);
+    let hostFile = `import * as zeus from './zeus';\n`;
+    if (opts.hostEnvironmentVariable) {
+        hostFile += `export const HUSAR_HOST = process.env.${opts.hostEnvironmentVariable};\n`;
+    }
+    else {
+        hostFile += `export const HUSAR_HOST = \n  process.env.HUSAR_HOST ||\n  process.env.NEXT_PUBLIC_HUSAR_HOST ||\n  process.env.VITE_HUSAR_HOST || '${opts.host}';\n`;
+    }
+    const authEnv = opts.authenticationEnvironmentVariable || 'HUSAR_API_KEY';
+    hostFile += `\nexport const getCmsHost = () => {\n  const husar_token = process.env.${authEnv};\n  const host = HUSAR_HOST ? new URL('content/graphql', HUSAR_HOST).toString() : zeus.HOST;\n  return [host, { ...(husar_token ? { headers: { husar_token } } : {}) }] as const;\n};\n`;
+    await fs.writeFile(path.join(cmsPath, 'host.ts'), hostFile);
+    await fs.writeFile(path.join(cmsPath, 'ssr.ts'), `import * as zeus from './zeus';
+import { husarClient } from '@husar.ai/ssr';
+import { getCmsHost } from './host';
+
+export const husar = husarClient<typeof zeus, zeus.ModelTypes>(zeus, ...getCmsHost());
+`);
+    await fs.writeFile(path.join(cmsPath, 'react.ts'), `import * as zeus from './zeus';
+import { HusarComponents } from '@husar.ai/render';
+import { getCmsHost } from './host';
+
+const { Shape, View, Model, Form } = HusarComponents<typeof zeus, zeus.ModelTypes>(getCmsHost());
+export { Shape, View, Model, Form };
+`);
+    return cmsPath;
+};
+//# sourceMappingURL=generate.js.map

package/dist/functions/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sourceRoot":"","sources":["../../src/functions/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAS7C,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAwB,EAAE,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpF,QAAQ,EAAE,KAAK;QACf,GAAG,EAAE,SAAS;KACf,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEpE,IAAI,QAAQ,GAAG,mCAAmC,CAAC;IACnD,IAAI,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACjC,QAAQ,IAAI,yCAAyC,IAAI,CAAC,uBAAuB,KAAK,CAAC;IACzF,CAAC;SAAM,CAAC;QACN,QAAQ,IAAI,uIAAuI,IAAI,CAAC,IAAI,MAAM,CAAC;IACrK,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,iCAAiC,IAAI,eAAe,CAAC;IAC1E,QAAQ,IAAI,0EAA0E,OAAO,0LAA0L,CAAC;IACxR,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAC;IAE5D,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,EAC5B;;;;;CAKH,CACE,CAAC;IAEF,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAC9B;;;;;;CAMH,CACE,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/mcp.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare const startMcpServer: () => Promise<void>;

package/dist/mcp.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { ConfigMaker } from 'config-maker';
+import { parser } from './functions/parser.js';
+import { generateCms } from './functions/generate.js';
+const server = new McpServer({ name: 'mcp-husar', version: '1.0.0' });
+let config;
+const getWorkspaceRoot = async () => {
+    const envRoot = process.env.WORKSPACE_ROOT;
+    if (envRoot)
+        return envRoot;
+    let cur = process.cwd();
+    for (let i = 0; i < 10; i++) {
+        try {
+            const pkgPath = path.join(cur, 'package.json');
+            const st = await fs.stat(pkgPath);
+            if (st.isFile()) {
+                const txt = await fs.readFile(pkgPath, 'utf8');
+                const pkg = JSON.parse(txt);
+                if (pkg && Object.prototype.hasOwnProperty.call(pkg, 'workspaces'))
+                    return cur;
+            }
+        }
+        catch {
+        }
+        const parent = path.dirname(cur);
+        if (parent === cur)
+            break;
+        cur = parent;
+    }
+    return process.cwd();
+};
+const resolveWorkspacePath = async (p) => {
+    if (path.isAbsolute(p))
+        return p;
+    const root = await getWorkspaceRoot();
+    return path.resolve(root, p);
+};
+const getConfig = async () => {
+    if (config)
+        return config;
+    const root = await getWorkspaceRoot();
+    config = new ConfigMaker('husar', {
+        decoders: {},
+        pathToProject: root,
+    });
+    return config;
+};
+const getAuth = async () => {
+    const envHost = process.env.HUSAR_MCP_HOST;
+    const envToken = process.env.HUSAR_MCP_ADMIN_TOKEN;
+    if (envHost && envToken)
+        return { host: envHost, adminToken: envToken };
+    try {
+        const cfg = await getConfig();
+        const { host, adminToken } = cfg.get();
+        if (host && adminToken)
+            return { host, adminToken };
+    }
+    catch {
+    }
+    throw new Error('Missing HUSAR_MCP_HOST and/or HUSAR_MCP_ADMIN_TOKEN. Provide via env or husar.json in workspace root. ' +
+        (await getWorkspaceRoot()));
+};
+const cmsParseFileInputFields = {
+    path: z
+        .string()
+        .min(1)
+        .describe('Path to the component/file. Accepts absolute paths or paths relative to the workspace root. Examples: "packages/playground/src/pages/examples/ContactForm.tsx" or "/home/user/repo/.../FeatureGrid.tsx". Supported: .tsx/.jsx/.ts/.js/.html'),
+    type: z
+        .enum(['model', 'shape'])
+        .optional()
+        .default('shape')
+        .describe('Target in CMS. Use "shape" for UI/component structures (default), or "model" for data models.'),
+    name: z
+        .string()
+        .optional()
+        .describe('Optional CMS name. Must not contain dashes (-). Prefer lowercase with underscores (e.g., examples_contactform). Defaults to the filename (lowercased).'),
+};
+const cmsParseFileInputSchema = z.object(cmsParseFileInputFields);
+const withTimeout = async (promise, ms) => {
+    let timeoutId;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new Error(`Operation timed out after ${ms} ms`)), ms);
+            }),
+        ]);
+    }
+    finally {
+        if (timeoutId)
+            clearTimeout(timeoutId);
+    }
+};
+const redirectConsoleToStderr = () => {
+    const original = {
+        log: console.log,
+        info: console.info,
+        debug: console.debug,
+        dir: console.dir,
+    };
+    console.log = (...args) => process.stderr.write(args.map(String).join(' ') + '\n');
+    console.info = (...args) => process.stderr.write(args.map(String).join(' ') + '\n');
+    console.debug = (...args) => process.stderr.write(args.map(String).join(' ') + '\n');
+    console.dir = (obj) => {
+        try {
+            const text = typeof obj === 'string' ? obj : JSON.stringify(obj, null, 2);
+            process.stderr.write(text + '\n');
+        }
+        catch {
+            process.stderr.write(String(obj) + '\n');
+        }
+        return obj;
+    };
+    return () => {
+        console.log = original.log;
+        console.info = original.info;
+        console.debug = original.debug;
+        console.dir = original.dir;
+    };
+};
+const createCmsParseFileHandler = ({ timeoutMs = 30_000 }) => {
+    return async ({ path: file, type, name: passed }) => {
+        const restoreConsole = redirectConsoleToStderr();
+        try {
+            const { host, adminToken } = await getAuth();
+            const absPath = await resolveWorkspacePath(file);
+            const name = (passed ?? (absPath.replace(/^.*\/(.*?)(\.[^.]+)?$/, '$1') || 'untitled')).toLowerCase();
+            const result = await withTimeout(parser(absPath, { type: (type ?? 'shape'), name }, {
+                HUSAR_MCP_HOST: host,
+                HUSAR_MCP_ADMIN_TOKEN: adminToken,
+            }), timeoutMs);
+            return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const stack = err instanceof Error && err.stack ? `\nStack: ${err.stack}` : '';
+            return { isError: true, content: [{ type: 'text', text: `Error: ${message}${stack}` }] };
+        }
+        finally {
+            try {
+                restoreConsole();
+            }
+            catch {
+            }
+        }
+    };
+};
+export const startMcpServer = async () => {
+    server.tool('cms_parse_file', 'Parse a CMS file into a shape or model', cmsParseFileInputFields, createCmsParseFileHandler({ timeoutMs: Number(process.env.MCP_PARSER_TIMEOUT_MS || 30000) }));
+    server.tool('husar_copy', 'Copy: parse HTML/JSX and upsert into CMS (model/shape)', cmsParseFileInputFields, createCmsParseFileHandler({ timeoutMs: Number(process.env.MCP_PARSER_TIMEOUT_MS || 30000) }));
+    const husarGenerateInput = {
+        folderPath: z
+            .string()
+            .optional()
+            .describe('Target folder for cms scaffolding. Relative to workspace root; defaults to ".".'),
+    };
+    const husarGenerateSchema = z.object(husarGenerateInput);
+    server.tool('husar_generate', 'Generate cms structure in the given path', husarGenerateInput, (async (args) => {
+        try {
+            const { folderPath } = husarGenerateSchema.parse(args ?? {});
+            const root = await getWorkspaceRoot();
+            const cfg = await getConfig();
+            const raw = cfg.get();
+            const host = raw.host || process.env.HUSAR_MCP_HOST || process.env.HUSAR_HOST;
+            if (!host) {
+                throw new Error('Missing host. Provide via husar.json (host) or HUSAR_MCP_HOST/HUSAR_HOST env.');
+            }
+            const base = folderPath ? await resolveWorkspacePath(folderPath) : root;
+            const cmsPath = await generateCms({
+                baseFolder: base,
+                host,
+                hostEnvironmentVariable: raw.hostEnvironmentVariable,
+                authenticationEnvironmentVariable: raw.authenticationEnvironmentVariable,
+            });
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'ok', folder: cmsPath }, null, 2) }] };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const stack = err instanceof Error && err.stack ? `\nStack: ${err.stack}` : '';
+            return { isError: true, content: [{ type: 'text', text: `Error: ${message}${stack}` }] };
+        }
+    }));
+    const transport = new StdioServerTransport();
+    server.connect(transport);
+    try {
+        if (typeof process.stdin.resume === 'function')
+            process.stdin.resume();
+    }
+    catch {
+    }
+    process.on('uncaughtException', (err) => {
+        const message = err instanceof Error ? `${err.message}\n${err.stack ?? ''}` : String(err);
+        try {
+            process.stderr.write(`[uncaughtException] ${message}\n`);
+        }
+        catch {
+        }
+    });
+    process.on('unhandledRejection', (reason) => {
+        const message = reason instanceof Error ? `${reason.message}\n${reason.stack ?? ''}` : String(reason);
+        try {
+            process.stderr.write(`[unhandledRejection] ${message}\n`);
+        }
+        catch {
+        }
+    });
+};
+if (import.meta.url === `file://${process.argv[1]}`) {
+    void startMcpServer();
+}
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"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"}

package/dist/mcp.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp.test.js

@@ -0,0 +1,27 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '../../..');
+test.skip('mcp server starts and stays alive briefly', async () => {
+    const child = spawn('node', [path.resolve(path.dirname(here), '../dist/mcp.js')], {
+        cwd: repoRoot,
+        env: {
+            ...process.env,
+            WORKSPACE_ROOT: repoRoot,
+            HUSAR_MCP_HOST: '',
+            HUSAR_MCP_ADMIN_TOKEN: '',
+        },
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    let exited = false;
+    child.on('exit', () => {
+        exited = true;
+    });
+    await new Promise((r) => setTimeout(r, 300));
+    assert.equal(exited, false);
+    child.kill('SIGKILL');
+});
+//# sourceMappingURL=mcp.test.js.map

package/dist/mcp.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.test.js","sourceRoot":"","sources":["../src/mcp.test.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AAEhD,IAAI,CAAC,IAAI,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;IAChE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC,CAAC,EAAE;QAChF,GAAG,EAAE,QAAQ;QACb,GAAG,EAAE;YACH,GAAG,OAAO,CAAC,GAAG;YACd,cAAc,EAAE,QAAQ;YACxB,cAAc,EAAE,EAAE;YAClB,qBAAqB,EAAE,EAAE;SAC1B;QACD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;IACH,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACxB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@husar.ai/cli",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "private": false,
   "type": "module",
   "main": "dist/cli.js",
@@ -12,12 +12,15 @@
   },
   "scripts": {
     "build": "tspc",
+    "test": "node --test --import tsx ./src/**/*.test.ts",
     "watch": "tspc --watch"
   },
   "dependencies": {
-    "@husar.ai/ssr": "^0.2.11",
+    "@husar.ai/ssr": "^0.2.13",
+    "@modelcontextprotocol/sdk": "^1.17.4",
     "commander": "^11.0.0",
-    "config-maker": "^0.0.6"
+    "config-maker": "^0.0.6",
+    "zod": "^3.23.8"
   },
   "devDependencies": {}
 }

package/src/cli.ts

@@ -2,11 +2,11 @@
 /* eslint-disable no-useless-escape */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import { Command } from 'commander';
-import fs, { constants } from 'node:fs/promises';
-import path from 'node:path';
-import { generateZeus } from '@husar.ai/ssr';
+// nofs
 import { ConfigMaker } from 'config-maker';
 import { parser } from './functions/parser.js';
+import { generateCms } from './functions/generate.js';
+import { startMcpServer } from './mcp.js';
 
 const config = new ConfigMaker<{
   host: string;
@@ -28,58 +28,12 @@ program
     const conf = config.get();
     const hostEnv = conf.hostEnvironmentVariable;
     const authenticationEnv = conf.authenticationEnvironmentVariable;
-    const cmsPath = path.join(folderPath, 'cms');
-    try {
-      await fs.access(cmsPath, constants.F_OK); // Check if folder exists
-      await fs.rm(cmsPath, { recursive: true, force: true });
-      console.log('Folder deleted.');
-    } catch (err: any) {
-      // noop
-    }
-    const zeusPath = path.join(cmsPath, 'zeus');
-    await fs.mkdir(zeusPath, { recursive: true });
-    const zeusCode = await generateZeus(new URL('content/graphql', host).toString(), {
-      esModule: false,
-      env: 'browser',
+    await generateCms({
+      baseFolder: folderPath,
+      host,
+      hostEnvironmentVariable: hostEnv,
+      authenticationEnvironmentVariable: authenticationEnv,
     });
-    await fs.writeFile(path.join(zeusPath, 'index.ts'), zeusCode.index);
-    await fs.writeFile(path.join(zeusPath, 'const.ts'), zeusCode.const);
-    let hostFile = `import * as zeus from './zeus';\n`;
-    if (hostEnv) {
-      hostFile += `export const HUSAR_HOST = process.env.${hostEnv};\n`;
-    } else {
-      hostFile += `export const HUSAR_HOST = 
-  process.env.HUSAR_HOST ||
-  process.env.NEXT_PUBLIC_HUSAR_HOST ||
-  process.env.VITE_HUSAR_HOST || '${host}';\n`;
-    }
-    hostFile += `
-export const getCmsHost = () => {
-  const husar_token = process.env.${authenticationEnv || 'HUSAR_API_KEY'};
-  const host = HUSAR_HOST ? new URL('content/graphql', HUSAR_HOST).toString() : zeus.HOST;
-  return [host, { ...(husar_token ? { headers: { husar_token } } : {}) }] as const;
-};
-`;
-    await fs.writeFile(path.join(cmsPath, 'host.ts'), hostFile);
-    await fs.writeFile(
-      path.join(cmsPath, 'ssr.ts'),
-      `import * as zeus from './zeus';
-import { husarClient } from '@husar.ai/ssr';
-import { getCmsHost } from './host';
-
-export const husar = husarClient<typeof zeus, zeus.ModelTypes>(zeus, ...getCmsHost());
-`,
-    );
-    await fs.writeFile(
-      path.join(cmsPath, 'react.ts'),
-      `import * as zeus from './zeus';
-import { HusarComponents } from '@husar.ai/render';
-import { getCmsHost } from './host';
-
-const { Shape, View, Model, Form } = HusarComponents<typeof zeus, zeus.ModelTypes>(getCmsHost());
-export { Shape, View, Model, Form };
-`,
-    );
   });
 
 program
@@ -102,4 +56,14 @@ program
     console.log(result ? 'File parsed and upserted successfully.' : 'Failed to parse and upsert file.');
   });
 
+program
+  .command('mcp')
+  .description('Run the Husar MCP server over stdio')
+  .action(async () => {
+    await startMcpServer();
+    // keep process alive
+    // eslint-disable-next-line @typescript-eslint/no-empty-function
+    await new Promise<void>(() => {});
+  });
+
 program.parse(process.argv);

package/src/functions/generate.ts

@@ -0,0 +1,66 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import fs, { constants } from 'node:fs/promises';
+import path from 'node:path';
+import { generateZeus } from '@husar.ai/ssr';
+
+export type GenerateCmsOptions = {
+  baseFolder: string; // absolute or relative to process.cwd()
+  host: string; // base URL, e.g., https://example.com
+  hostEnvironmentVariable?: string;
+  authenticationEnvironmentVariable?: string; // env var name for token
+};
+
+export const generateCms = async (opts: GenerateCmsOptions) => {
+  const base = path.resolve(process.cwd(), opts.baseFolder || '.');
+  const cmsPath = path.join(base, 'cms');
+  try {
+    await fs.access(cmsPath, constants.F_OK);
+    await fs.rm(cmsPath, { recursive: true, force: true });
+  } catch {
+    // ignore if not exists
+  }
+
+  const zeusPath = path.join(cmsPath, 'zeus');
+  await fs.mkdir(zeusPath, { recursive: true });
+
+  const zeusCode = await generateZeus(new URL('content/graphql', opts.host).toString(), {
+    esModule: false,
+    env: 'browser',
+  });
+  await fs.writeFile(path.join(zeusPath, 'index.ts'), zeusCode.index);
+  await fs.writeFile(path.join(zeusPath, 'const.ts'), zeusCode.const);
+
+  let hostFile = `import * as zeus from './zeus';\n`;
+  if (opts.hostEnvironmentVariable) {
+    hostFile += `export const HUSAR_HOST = process.env.${opts.hostEnvironmentVariable};\n`;
+  } else {
+    hostFile += `export const HUSAR_HOST = \n  process.env.HUSAR_HOST ||\n  process.env.NEXT_PUBLIC_HUSAR_HOST ||\n  process.env.VITE_HUSAR_HOST || '${opts.host}';\n`;
+  }
+  const authEnv = opts.authenticationEnvironmentVariable || 'HUSAR_API_KEY';
+  hostFile += `\nexport const getCmsHost = () => {\n  const husar_token = process.env.${authEnv};\n  const host = HUSAR_HOST ? new URL('content/graphql', HUSAR_HOST).toString() : zeus.HOST;\n  return [host, { ...(husar_token ? { headers: { husar_token } } : {}) }] as const;\n};\n`;
+  await fs.writeFile(path.join(cmsPath, 'host.ts'), hostFile);
+
+  await fs.writeFile(
+    path.join(cmsPath, 'ssr.ts'),
+    `import * as zeus from './zeus';
+import { husarClient } from '@husar.ai/ssr';
+import { getCmsHost } from './host';
+
+export const husar = husarClient<typeof zeus, zeus.ModelTypes>(zeus, ...getCmsHost());
+`,
+  );
+
+  await fs.writeFile(
+    path.join(cmsPath, 'react.ts'),
+    `import * as zeus from './zeus';
+import { HusarComponents } from '@husar.ai/render';
+import { getCmsHost } from './host';
+
+const { Shape, View, Model, Form } = HusarComponents<typeof zeus, zeus.ModelTypes>(getCmsHost());
+export { Shape, View, Model, Form };
+`,
+  );
+
+  return cmsPath;
+};
+

package/src/mcp.test.ts

@@ -0,0 +1,31 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { spawn } from 'node:child_process';
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const repoRoot = path.resolve(here, '../../..');
+
+test.skip('mcp server starts and stays alive briefly', async () => {
+  const child = spawn('node', [path.resolve(path.dirname(here), '../dist/mcp.js')], {
+    cwd: repoRoot,
+    env: {
+      ...process.env,
+      WORKSPACE_ROOT: repoRoot,
+      HUSAR_MCP_HOST: '',
+      HUSAR_MCP_ADMIN_TOKEN: '',
+    },
+    stdio: ['pipe', 'pipe', 'pipe'],
+  });
+  let exited = false;
+  child.on('exit', () => {
+    exited = true;
+  });
+  // wait a short period to ensure the process stays running
+  await new Promise((r) => setTimeout(r, 300));
+  assert.equal(exited, false);
+  // cleanup
+  child.kill('SIGKILL');
+});

package/src/mcp.ts

@@ -0,0 +1,256 @@
+#!/usr/bin/env node
+/* eslint-disable @typescript-eslint/no-explicit-any */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { z } from 'zod';
+import { ConfigMaker } from 'config-maker';
+import { parser } from './functions/parser.js';
+import { generateCms } from './functions/generate.js';
+
+const server = new McpServer({ name: 'mcp-husar', version: '1.0.0' });
+
+let config: ConfigMaker<{ host: string; adminToken: string }> | undefined;
+
+const getWorkspaceRoot = async (): Promise<string> => {
+  const envRoot = process.env.WORKSPACE_ROOT;
+  if (envRoot) return envRoot;
+  let cur = process.cwd();
+  for (let i = 0; i < 10; i++) {
+    try {
+      const pkgPath = path.join(cur, 'package.json');
+      const st = await fs.stat(pkgPath);
+      if (st.isFile()) {
+        const txt = await fs.readFile(pkgPath, 'utf8');
+        const pkg = JSON.parse(txt) as { workspaces?: unknown };
+        if (pkg && Object.prototype.hasOwnProperty.call(pkg, 'workspaces')) return cur;
+      }
+    } catch {
+      /* empty */
+    }
+    const parent = path.dirname(cur);
+    if (parent === cur) break;
+    cur = parent;
+  }
+  return process.cwd();
+};
+
+const resolveWorkspacePath = async (p: string): Promise<string> => {
+  if (path.isAbsolute(p)) return p;
+  const root = await getWorkspaceRoot();
+  return path.resolve(root, p);
+};
+
+const getConfig = async () => {
+  if (config) return config;
+  const root = await getWorkspaceRoot();
+  config = new ConfigMaker<{ host: string; adminToken: string }>('husar', {
+    decoders: {},
+    pathToProject: root,
+  });
+  return config;
+};
+
+const getAuth = async () => {
+  const envHost = process.env.HUSAR_MCP_HOST;
+  const envToken = process.env.HUSAR_MCP_ADMIN_TOKEN;
+  if (envHost && envToken) return { host: envHost, adminToken: envToken } as const;
+
+  // Non-interactive: read current config values only
+  try {
+    const cfg = await getConfig();
+    const { host, adminToken } = cfg.get();
+    if (host && adminToken) return { host, adminToken } as const;
+  } catch {
+    // ignore; we'll throw below
+  }
+
+  throw new Error(
+    'Missing HUSAR_MCP_HOST and/or HUSAR_MCP_ADMIN_TOKEN. Provide via env or husar.json in workspace root. ' +
+      (await getWorkspaceRoot()),
+  );
+};
+
+const cmsParseFileInputFields = {
+  path: z
+    .string()
+    .min(1)
+    .describe(
+      'Path to the component/file. Accepts absolute paths or paths relative to the workspace root. Examples: "packages/playground/src/pages/examples/ContactForm.tsx" or "/home/user/repo/.../FeatureGrid.tsx". Supported: .tsx/.jsx/.ts/.js/.html',
+    ),
+  type: z
+    .enum(['model', 'shape'])
+    .optional()
+    .default('shape')
+    .describe('Target in CMS. Use "shape" for UI/component structures (default), or "model" for data models.'),
+  name: z
+    .string()
+    .optional()
+    .describe(
+      'Optional CMS name. Must not contain dashes (-). Prefer lowercase with underscores (e.g., examples_contactform). Defaults to the filename (lowercased).',
+    ),
+};
+
+const cmsParseFileInputSchema = z.object(cmsParseFileInputFields);
+type CmsParseFileInput = z.infer<typeof cmsParseFileInputSchema>;
+
+const withTimeout = async <T>(promise: Promise<T>, ms: number): Promise<T> => {
+  let timeoutId: NodeJS.Timeout | undefined;
+  try {
+    return await Promise.race([
+      promise,
+      new Promise<T>((_, reject) => {
+        timeoutId = setTimeout(() => reject(new Error(`Operation timed out after ${ms} ms`)), ms);
+      }),
+    ]);
+  } finally {
+    if (timeoutId) clearTimeout(timeoutId);
+  }
+};
+
+const redirectConsoleToStderr = () => {
+  const original = {
+    log: console.log,
+    info: console.info,
+    debug: console.debug,
+    dir: console.dir,
+  } as const;
+  console.log = (...args: unknown[]) => process.stderr.write(args.map(String).join(' ') + '\n');
+  console.info = (...args: unknown[]) => process.stderr.write(args.map(String).join(' ') + '\n');
+  console.debug = (...args: unknown[]) => process.stderr.write(args.map(String).join(' ') + '\n');
+  console.dir = (obj: unknown) => {
+    try {
+      const text = typeof obj === 'string' ? obj : JSON.stringify(obj, null, 2);
+      process.stderr.write(text + '\n');
+    } catch {
+      process.stderr.write(String(obj) + '\n');
+    }
+    return obj as never;
+  };
+  return () => {
+    console.log = original.log;
+    console.info = original.info;
+    console.debug = original.debug;
+    console.dir = original.dir;
+  };
+};
+
+const createCmsParseFileHandler = ({ timeoutMs = 30_000 }: { timeoutMs?: number }) => {
+  return async ({ path: file, type, name: passed }: CmsParseFileInput) => {
+    const restoreConsole = redirectConsoleToStderr();
+    try {
+      const { host, adminToken } = await getAuth();
+      const absPath = await resolveWorkspacePath(file);
+      const name = (passed ?? (absPath.replace(/^.*\/(.*?)(\.[^.]+)?$/, '$1') || 'untitled')).toLowerCase();
+      const result = await withTimeout(
+        parser(
+          absPath,
+          { type: (type ?? 'shape') as 'model' | 'shape', name },
+          {
+            HUSAR_MCP_HOST: host,
+            HUSAR_MCP_ADMIN_TOKEN: adminToken,
+          },
+        ),
+        timeoutMs,
+      );
+      return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const stack = err instanceof Error && err.stack ? `\nStack: ${err.stack}` : '';
+      return { isError: true, content: [{ type: 'text', text: `Error: ${message}${stack}` }] };
+    } finally {
+      try {
+        restoreConsole();
+      } catch {
+        /* no-op */
+      }
+    }
+  };
+};
+
+export const startMcpServer = async () => {
+  // Tool: cms_parse_file (legacy)
+  server.tool(
+    'cms_parse_file',
+    'Parse a CMS file into a shape or model',
+    cmsParseFileInputFields,
+    createCmsParseFileHandler({ timeoutMs: Number(process.env.MCP_PARSER_TIMEOUT_MS || 30000) }) as any,
+  );
+
+  // Tool: husar_copy (alias)
+  server.tool(
+    'husar_copy',
+    'Copy: parse HTML/JSX and upsert into CMS (model/shape)',
+    cmsParseFileInputFields,
+    createCmsParseFileHandler({ timeoutMs: Number(process.env.MCP_PARSER_TIMEOUT_MS || 30000) }) as any,
+  );
+
+  // Tool: husar_generate
+  const husarGenerateInput = {
+    folderPath: z
+      .string()
+      .optional()
+      .describe('Target folder for cms scaffolding. Relative to workspace root; defaults to ".".'),
+  } as const;
+  const husarGenerateSchema = z.object(husarGenerateInput);
+  server.tool('husar_generate', 'Generate cms structure in the given path', husarGenerateInput, (async (
+    args: unknown,
+  ) => {
+    try {
+      const { folderPath } = husarGenerateSchema.parse(args ?? {});
+      const root = await getWorkspaceRoot();
+      const cfg = await getConfig();
+      const raw = cfg.get();
+      const host = raw.host || process.env.HUSAR_MCP_HOST || process.env.HUSAR_HOST;
+      if (!host) {
+        throw new Error('Missing host. Provide via husar.json (host) or HUSAR_MCP_HOST/HUSAR_HOST env.');
+      }
+      const base = folderPath ? await resolveWorkspacePath(folderPath) : root;
+      const cmsPath = await generateCms({
+        baseFolder: base,
+        host,
+        hostEnvironmentVariable: (raw as any).hostEnvironmentVariable,
+        authenticationEnvironmentVariable: (raw as any).authenticationEnvironmentVariable,
+      });
+      return { content: [{ type: 'text', text: JSON.stringify({ status: 'ok', folder: cmsPath }, null, 2) }] };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : String(err);
+      const stack = err instanceof Error && err.stack ? `\nStack: ${err.stack}` : '';
+      return { isError: true, content: [{ type: 'text', text: `Error: ${message}${stack}` }] };
+    }
+  }) as any);
+
+  const transport = new StdioServerTransport();
+  server.connect(transport);
+  try {
+    // Ensure the event loop stays active even if no client is attached yet
+    if (typeof process.stdin.resume === 'function') process.stdin.resume();
+  } catch {
+    /* ignore */
+  }
+
+  process.on('uncaughtException', (err) => {
+    const message = err instanceof Error ? `${err.message}\n${err.stack ?? ''}` : String(err);
+    try {
+      process.stderr.write(`[uncaughtException] ${message}\n`);
+    } catch {
+      /* ignore */
+    }
+  });
+
+  process.on('unhandledRejection', (reason) => {
+    const message = reason instanceof Error ? `${reason.message}\n${reason.stack ?? ''}` : String(reason);
+    try {
+      process.stderr.write(`[unhandledRejection] ${message}\n`);
+    } catch {
+      /* ignore */
+    }
+  });
+};
+
+// Allow running directly via ts-node/tsx
+if (import.meta.url === `file://${process.argv[1]}`) {
+  // eslint-disable-next-line no-void
+  void startMcpServer();
+}