wavemaker-dev-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WaveMaker Dev MCP contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# wavemaker-dev-mcp
+
+An MCP (Model Context Protocol) server that exposes **read-only** tools to search and read:
+
+- **`@wavemaker/react-runtime`** — component sources, `props.js` / `props.ts`, and references to widget names
+- **`@wavemaker/foundation-css`** or **`@wavemaker-ai/foundation-css`** — tokens, LESS, and CSS
+
+There are **no embeddings** and **no vector DB**. Search uses [ripgrep](https://github.com/BurntSushi/ripgrep) when available, with a Node.js fallback.
+
+## Requirements
+
+- Node.js 18+
+- A project that installs `@wavemaker/react-runtime` and (optionally) `@wavemaker/foundation-css` under `node_modules`
+- Optional: `rg` on `PATH` for faster search
+
+## Install
+
+```bash
+git clone <your-repo-url> wavemaker-dev-mcp
+cd wavemaker-dev-mcp
+npm install
+npm run build
+```
+
+The published npm package includes `dist/`; a git clone must run `npm run build` before using `dist/index.js` in MCP config.
+
+## Local testing (MCP Inspector)
+
+Use [@modelcontextprotocol/inspector](https://www.npmjs.com/package/@modelcontextprotocol/inspector) to exercise the server in a browser. The inspector expects **Node.js ≥ 22.7.5**.
+
+From this repository root (after `npm run build` so `dist/index.js` exists):
+
+```bash
+npx @modelcontextprotocol/inspector --config mcp.json --server wavemaker-dev
+```
+
+If `mcp.json` defines only this server, `--server wavemaker-dev` may be omitted. Open the UI URL printed in the terminal (default **http://localhost:6274**). When prompted, use the session token from the console to authenticate to the proxy.
+
+Point the server at your WaveMaker app or source clones by adding an `env` block to the `wavemaker-dev` entry in `mcp.json` (see **Environment variables** below), or set variables in your shell before the `npx` command.
+
+## Environment variables
+
+| Variable | Purpose |
+|----------|---------|
+| `WM_PROJECT_ROOT` | App root (directory containing `node_modules`). Used when the MCP process `cwd` is not your app. Overridden by the `workingDirectory` tool argument when set. |
+| `WM_REACT_RUNTIME_ROOT` | Absolute path to `@wavemaker/react-runtime` (skips `node_modules` lookup). |
+| `WM_FOUNDATION_CSS_ROOT` | Absolute path to the foundation-css package root. |
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `get_wavemaker_roots` | Show resolved paths for react-runtime and foundation-css. |
+| `search_wavemaker_runtime` | Search inside the react-runtime package (`pattern`, optional `fileGlob`, `maxResults`). |
+| `read_wavemaker_runtime_file` | Read a file relative to that package (e.g. `components/input/select/props.js`). |
+| `search_foundation_css` | Search inside foundation-css. |
+| `read_foundation_css_file` | Read a file relative to foundation-css. |
+| `find_wavemaker_component` | Given a name like `WmSelect` or `select`, list matching `props` paths and sample references under `components/`. |
+
+## Cursor
+
+Add a **global** or **project** MCP config so the server runs with **`cwd` set to your WaveMaker app** (the folder that contains `node_modules`).
+
+Example (adjust absolute paths):
+
+```json
+{
+  "mcpServers": {
+    "wavemaker-dev": {
+      "command": "node",
+      "args": ["/path/to/wavemaker-dev-mcp/dist/index.js"],
+      "cwd": "/path/to/your-wm-react-app"
+    }
+  }
+}
+```
+
+If you cannot set `cwd`, set `WM_PROJECT_ROOT` to your app root (e.g. `env` in the MCP server entry, if your client supports it).
+
+After publishing to npm, you can use:
+
+```json
+{
+  "mcpServers": {
+    "wavemaker-dev": {
+      "command": "npx",
+      "args": ["-y", "wavemaker-dev-mcp"],
+      "cwd": "/path/to/your-wm-react-app"
+    }
+  }
+}
+```
+
+## Tests (Playwright)
+
+Integration tests spawn the server over stdio with the official MCP client and call tools. They expect a WaveMaker app at `../wm-react-base-app` (sibling directory) or set **`WM_TEST_APP_ROOT`** to an app root that contains `node_modules/@wavemaker/react-runtime`.
+
+```bash
+npm run build
+npm test
+```
+
+## License
+
+MIT

package/dist/components.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Strip leading `Wm` and lowercase (e.g. WmSelect -> select).
+ */
+export declare function normalizeComponentQuery(name: string): string;
+/**
+ * Build a likely `Wm*` name from user input (`select` -> `WmSelect`, `WmButton` -> `WmButton`).
+ */
+export declare function toWmComponentName(input: string): string;
+/**
+ * Find props files under `.../components` whose path likely matches the widget (e.g. `.../select/props.js`).
+ */
+export declare function findPropsPathsByHint(runtimeRoot: string, hint: string): Promise<string[]>;
+/**
+ * Find references to a component name in source (fallback when path hint fails).
+ */
+export declare function findComponentRefs(runtimeRoot: string, componentName: string, maxResults: number): Promise<import("./search.js").ContentMatch[]>;
+//# sourceMappingURL=components.d.ts.map

package/dist/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAgB/F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iDAOrG"}

package/dist/components.js

@@ -0,0 +1,67 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeComponentQuery = normalizeComponentQuery;
+exports.toWmComponentName = toWmComponentName;
+exports.findPropsPathsByHint = findPropsPathsByHint;
+exports.findComponentRefs = findComponentRefs;
+const node_path_1 = __importDefault(require("node:path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const paths_js_1 = require("./paths.js");
+const search_js_1 = require("./search.js");
+/**
+ * Strip leading `Wm` and lowercase (e.g. WmSelect -> select).
+ */
+function normalizeComponentQuery(name) {
+    let s = name.trim();
+    if (s.startsWith("Wm"))
+        s = s.slice(2);
+    return s.toLowerCase();
+}
+/**
+ * Build a likely `Wm*` name from user input (`select` -> `WmSelect`, `WmButton` -> `WmButton`).
+ */
+function toWmComponentName(input) {
+    const s = input.trim().replace(/^Wm/i, "");
+    if (!s)
+        return input.trim();
+    const pascal = s.charAt(0).toUpperCase() + s.slice(1);
+    return `Wm${pascal}`;
+}
+/**
+ * Find props files under `.../components` whose path likely matches the widget (e.g. `.../select/props.js`).
+ */
+async function findPropsPathsByHint(runtimeRoot, hint) {
+    const key = normalizeComponentQuery(hint);
+    if (!key)
+        return [];
+    const componentsRoot = (0, paths_js_1.resolveRuntimeComponentsRoot)(runtimeRoot);
+    const files = await (0, fast_glob_1.default)("**/props.{js,ts}", {
+        cwd: componentsRoot,
+        onlyFiles: true,
+        dot: false,
+    });
+    const matches = files.filter((f) => {
+        const lower = f.toLowerCase();
+        return lower.includes(`/${key}/`) || lower.includes(`/${key}.`) || lower.startsWith(`${key}/`);
+    });
+    return matches
+        .map((f) => node_path_1.default.relative(runtimeRoot, node_path_1.default.join(componentsRoot, f)).replace(/\\/g, "/"))
+        .sort();
+}
+/**
+ * Find references to a component name in source (fallback when path hint fails).
+ */
+async function findComponentRefs(runtimeRoot, componentName, maxResults) {
+    const pattern = componentName.trim();
+    if (!pattern)
+        return [];
+    const componentsRoot = (0, paths_js_1.resolveRuntimeComponentsRoot)(runtimeRoot);
+    const rg = (0, search_js_1.searchWithRipgrep)(componentsRoot, pattern, maxResults);
+    if (rg !== null)
+        return rg;
+    return (0, search_js_1.searchWithNode)(componentsRoot, pattern, maxResults, "**/*.{js,ts,tsx,jsx}");
+}
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.js","sourceRoot":"","sources":["../src/components.ts"],"names":[],"mappings":";;;;;AAQA,0DAIC;AAKD,8CAKC;AAKD,oDAgBC;AAKD,8CAOC;AAvDD,0DAA6B;AAC7B,0DAA2B;AAC3B,yCAA0D;AAC1D,2CAAgE;AAEhE;;GAEG;AACH,SAAgB,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACpB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACvC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAa;IAC7C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,KAAK,MAAM,EAAE,CAAC;AACvB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,oBAAoB,CAAC,WAAmB,EAAE,IAAY;IAC1E,MAAM,GAAG,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,cAAc,GAAG,IAAA,uCAA4B,EAAC,WAAW,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAE,EAAC,kBAAkB,EAAE;QACzC,GAAG,EAAE,cAAc;QACnB,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;KACX,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IACH,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,mBAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,mBAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SACxF,IAAI,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,iBAAiB,CAAC,WAAmB,EAAE,aAAqB,EAAE,UAAkB;IACpG,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,cAAc,GAAG,IAAA,uCAA4B,EAAC,WAAW,CAAC,CAAC;IACjE,MAAM,EAAE,GAAG,IAAA,6BAAiB,EAAC,cAAc,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IAClE,IAAI,EAAE,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,IAAA,0BAAc,EAAC,cAAc,EAAE,OAAO,EAAE,UAAU,EAAE,sBAAsB,CAAC,CAAC;AACrF,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_fs_1 = __importDefault(require("node:fs"));
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const zod_1 = require("zod");
+const components_js_1 = require("./components.js");
+const paths_js_1 = require("./paths.js");
+const search_js_1 = require("./search.js");
+function resolveProjectRoot(workingDirectory) {
+    return workingDirectory ?? process.env.WM_PROJECT_ROOT?.trim() ?? process.cwd();
+}
+const MAX_READ_BYTES = 512 * 1024;
+const MAX_LINES_PREVIEW = 400;
+function readFileSlice(absolute, startLine, endLine) {
+    const buf = node_fs_1.default.readFileSync(absolute);
+    let text = buf.length > MAX_READ_BYTES ? buf.subarray(0, MAX_READ_BYTES).toString("utf8") : buf.toString("utf8");
+    let truncated = buf.length > MAX_READ_BYTES;
+    const lines = text.split(/\r?\n/);
+    if (startLine !== undefined || endLine !== undefined) {
+        const start = Math.max(1, startLine ?? 1) - 1;
+        const end = endLine === undefined ? lines.length : Math.min(lines.length, endLine);
+        const slice = lines.slice(start, end);
+        if (slice.length > MAX_LINES_PREVIEW) {
+            truncated = true;
+            return { text: slice.slice(0, MAX_LINES_PREVIEW).join("\n"), truncated };
+        }
+        return { text: slice.join("\n"), truncated };
+    }
+    if (lines.length > MAX_LINES_PREVIEW) {
+        return { text: lines.slice(0, MAX_LINES_PREVIEW).join("\n"), truncated: true };
+    }
+    return { text, truncated };
+}
+const workingDirSchema = zod_1.z
+    .string()
+    .optional()
+    .describe("Project root (directory containing node_modules). Defaults to process.cwd(). Set when the MCP process cwd is not your app root.");
+async function main() {
+    const mcp = new mcp_js_1.McpServer({
+        name: "wavemaker-dev-mcp",
+        version: "0.1.0",
+        title: "WaveMaker React & Foundation CSS",
+    });
+    mcp.registerTool("get_wavemaker_roots", {
+        title: "Resolve WaveMaker package paths",
+        description: "Returns resolved paths for react-runtime and foundation-css. Resolution order: WM_*_SOURCE (local clone) → WM_*_ROOT → node_modules. Call this first if searches fail.",
+        inputSchema: { workingDirectory: workingDirSchema },
+    }, async ({ workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        const lines = [
+            `projectRoot: ${roots.projectRoot}`,
+            roots.reactRuntime
+                ? `reactRuntime: ${roots.reactRuntime.path} [${roots.reactRuntime.resolution}]`
+                : "reactRuntime: NOT FOUND (set WM_REACT_RUNTIME_SOURCE or WM_REACT_RUNTIME_ROOT, or install @wavemaker/react-runtime under node_modules)",
+            roots.foundationCss
+                ? `foundationCss: ${roots.foundationCss.path} [${roots.foundationCss.resolution}, ${roots.foundationCss.packageName}]`
+                : "foundationCss: NOT FOUND (set WM_FOUNDATION_CSS_SOURCE or WM_FOUNDATION_CSS_ROOT, or install @wavemaker/foundation-css under node_modules)",
+        ];
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+    mcp.registerTool("search_wavemaker_runtime", {
+        title: "Search @wavemaker/react-runtime sources",
+        description: "Ripgrep (or Node fallback) over the installed react-runtime package for symbols, props, or text. Use fileGlob like **/*.js or **/props.js to narrow scope.",
+        inputSchema: {
+            pattern: zod_1.z.string().describe("Regular expression or literal (Node fallback escapes if invalid regex)."),
+            maxResults: zod_1.z.number().optional().describe("Max matches (default 40)."),
+            fileGlob: zod_1.z.string().optional().describe("Optional glob relative to package root, e.g. **/props.js"),
+            workingDirectory: workingDirSchema,
+        },
+    }, async ({ pattern, maxResults, fileGlob, workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        if (!roots.reactRuntime) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "react-runtime not found. Run get_wavemaker_roots or install @wavemaker/react-runtime." }],
+            };
+        }
+        const max = Math.min(200, Math.max(1, maxResults ?? 40));
+        const root = roots.reactRuntime.path;
+        let matches = (0, search_js_1.searchWithRipgrep)(root, pattern, max, fileGlob);
+        if (matches === null) {
+            matches = await (0, search_js_1.searchWithNode)(root, pattern, max, fileGlob);
+        }
+        return { content: [{ type: "text", text: (0, search_js_1.formatMatches)("react-runtime", root, matches) }] };
+    });
+    mcp.registerTool("read_wavemaker_runtime_file", {
+        title: "Read a file under @wavemaker/react-runtime",
+        description: "Read a file from the resolved react-runtime root (published package or local clone). Use components/... for npm installs or src/components/... when using WM_REACT_RUNTIME_SOURCE.",
+        inputSchema: {
+            relativePath: zod_1.z
+                .string()
+                .describe("Path under react-runtime root, e.g. components/input/select/props.js or src/components/input/select/props.ts"),
+            startLine: zod_1.z.number().optional().describe("1-based start line (optional)."),
+            endLine: zod_1.z.number().optional().describe("1-based end line inclusive (optional)."),
+            workingDirectory: workingDirSchema,
+        },
+    }, async ({ relativePath, startLine, endLine, workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        if (!roots.reactRuntime) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "react-runtime not found." }],
+            };
+        }
+        const check = (0, paths_js_1.safeReadUnderRoot)(roots.reactRuntime.path, relativePath);
+        if (!check.ok) {
+            return { isError: true, content: [{ type: "text", text: check.error }] };
+        }
+        if (!node_fs_1.default.existsSync(check.absolute) || !node_fs_1.default.statSync(check.absolute).isFile()) {
+            return { isError: true, content: [{ type: "text", text: `Not a file: ${relativePath}` }] };
+        }
+        const { text, truncated } = readFileSlice(check.absolute, startLine, endLine);
+        const header = `${check.absolute}${truncated ? "\n[truncated]" : ""}\n\n`;
+        return { content: [{ type: "text", text: header + text }] };
+    });
+    mcp.registerTool("search_foundation_css", {
+        title: "Search @wavemaker/foundation-css (or @wavemaker-ai/foundation-css)",
+        description: "Search tokens, LESS, and CSS under the foundation-css package for variables, classes, or snippets.",
+        inputSchema: {
+            pattern: zod_1.z.string(),
+            maxResults: zod_1.z.number().optional(),
+            fileGlob: zod_1.z.string().optional(),
+            workingDirectory: workingDirSchema,
+        },
+    }, async ({ pattern, maxResults, fileGlob, workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        if (!roots.foundationCss) {
+            return {
+                isError: true,
+                content: [
+                    {
+                        type: "text",
+                        text: "foundation-css not found. Install @wavemaker/foundation-css or set WM_FOUNDATION_CSS_ROOT.",
+                    },
+                ],
+            };
+        }
+        const max = Math.min(200, Math.max(1, maxResults ?? 40));
+        const root = roots.foundationCss.path;
+        let matches = (0, search_js_1.searchWithRipgrep)(root, pattern, max, fileGlob);
+        if (matches === null) {
+            matches = await (0, search_js_1.searchWithNode)(root, pattern, max, fileGlob);
+        }
+        return { content: [{ type: "text", text: (0, search_js_1.formatMatches)("foundation-css", root, matches) }] };
+    });
+    mcp.registerTool("read_foundation_css_file", {
+        title: "Read a file under foundation-css",
+        description: "Read a file from the foundation-css package (tokens, LESS, CSS). Path is relative to package root.",
+        inputSchema: {
+            relativePath: zod_1.z.string(),
+            startLine: zod_1.z.number().optional(),
+            endLine: zod_1.z.number().optional(),
+            workingDirectory: workingDirSchema,
+        },
+    }, async ({ relativePath, startLine, endLine, workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        if (!roots.foundationCss) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "foundation-css not found." }],
+            };
+        }
+        const check = (0, paths_js_1.safeReadUnderRoot)(roots.foundationCss.path, relativePath);
+        if (!check.ok) {
+            return { isError: true, content: [{ type: "text", text: check.error }] };
+        }
+        if (!node_fs_1.default.existsSync(check.absolute) || !node_fs_1.default.statSync(check.absolute).isFile()) {
+            return { isError: true, content: [{ type: "text", text: `Not a file: ${relativePath}` }] };
+        }
+        const { text, truncated } = readFileSlice(check.absolute, startLine, endLine);
+        const header = `${check.absolute}${truncated ? "\n[truncated]" : ""}\n\n`;
+        return { content: [{ type: "text", text: header + text }] };
+    });
+    mcp.registerTool("find_wavemaker_component", {
+        title: "Find props / paths for a WaveMaker widget",
+        description: "Given a widget name like WmSelect or WmButton, list matching props.js/ts paths under components/, and optionally search for the name in source when path matching is ambiguous (e.g. charts).",
+        inputSchema: {
+            componentName: zod_1.z.string().describe('e.g. "WmSelect", "WmBarChart", or "select"'),
+            workingDirectory: workingDirSchema,
+        },
+    }, async ({ componentName, workingDirectory }) => {
+        const roots = (0, paths_js_1.resolveRoots)(resolveProjectRoot(workingDirectory));
+        if (!roots.reactRuntime) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: "react-runtime not found." }],
+            };
+        }
+        const root = roots.reactRuntime.path;
+        const hints = await (0, components_js_1.findPropsPathsByHint)(root, componentName);
+        const wmName = (0, components_js_1.toWmComponentName)(componentName);
+        const refs = await (0, components_js_1.findComponentRefs)(root, wmName, 20);
+        const lines = [
+            `react-runtime: ${root}`,
+            `normalized name for source search: ${wmName}`,
+            "",
+            "Props files matching path hint (components/**/props.*):",
+            hints.length ? hints.map((p) => `  ${p}`).join("\n") : "  (none — charts and some widgets use non-obvious folder names; use refs below or search_wavemaker_runtime)",
+            "",
+            `References to "${wmName}" under components/ (sample):`,
+            refs.length ? (0, search_js_1.formatMatches)("refs", (0, paths_js_1.resolveRuntimeComponentsRoot)(root), refs) : "  (none)",
+        ];
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+    const transport = new stdio_js_1.StdioServerTransport();
+    await mcp.connect(transport);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/paths.d.ts

@@ -0,0 +1,43 @@
+export declare function existsDir(p: string): boolean;
+/**
+ * How the react-runtime root was chosen (first match wins).
+ */
+export type ReactRuntimeResolution = "WM_REACT_RUNTIME_SOURCE" | "WM_REACT_RUNTIME_ROOT" | `node_modules:${string}`;
+/**
+ * How the foundation-css root was chosen (first match wins).
+ */
+export type FoundationResolution = "WM_FOUNDATION_CSS_SOURCE" | "WM_FOUNDATION_CSS_ROOT" | `node_modules:${string}`;
+export type ResolvedRoots = {
+    projectRoot: string;
+    reactRuntime: {
+        path: string;
+        resolution: ReactRuntimeResolution;
+    } | null;
+    foundationCss: {
+        path: string;
+        resolution: FoundationResolution;
+        packageName: string;
+    } | null;
+};
+/**
+ * Prefer local source clones, then explicit package roots, then node_modules.
+ *
+ * React runtime: `WM_REACT_RUNTIME_SOURCE` → `WM_REACT_RUNTIME_ROOT` → `node_modules/@wavemaker/react-runtime`
+ * Foundation: `WM_FOUNDATION_CSS_SOURCE` → `WM_FOUNDATION_CSS_ROOT` → `node_modules` packages
+ */
+export declare function resolveRoots(cwd?: string): ResolvedRoots;
+/**
+ * Local react-runtime repos often use `src/components`; published packages use `components`.
+ */
+export declare function resolveRuntimeComponentsRoot(runtimeRoot: string): string;
+/**
+ * Ensure `relativePath` resolves under `root` (no traversal).
+ */
+export declare function safeReadUnderRoot(root: string, relativePath: string): {
+    ok: true;
+    absolute: string;
+} | {
+    ok: false;
+    error: string;
+};
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAMA,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAM5C;AAQD;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,MAAM,EAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,wBAAwB,GAAG,gBAAgB,MAAM,EAAE,CAAC;AAEpH,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,sBAAsB,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1E,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,oBAAoB,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/F,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,SAAgB,GAAG,aAAa,CA6C/D;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQnI"}

package/dist/paths.js

@@ -0,0 +1,103 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.existsDir = existsDir;
+exports.resolveRoots = resolveRoots;
+exports.resolveRuntimeComponentsRoot = resolveRuntimeComponentsRoot;
+exports.safeReadUnderRoot = safeReadUnderRoot;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const RUNTIME_PKG = "@wavemaker/react-runtime";
+const FOUNDATION_CANDIDATES = ["@wavemaker/foundation-css", "@wavemaker-ai/foundation-css"];
+function existsDir(p) {
+    try {
+        return node_fs_1.default.statSync(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+function resolvePackageDir(projectRoot, packageName) {
+    const nested = node_path_1.default.join(projectRoot, "node_modules", packageName);
+    if (existsDir(nested))
+        return nested;
+    return null;
+}
+/**
+ * Prefer local source clones, then explicit package roots, then node_modules.
+ *
+ * React runtime: `WM_REACT_RUNTIME_SOURCE` → `WM_REACT_RUNTIME_ROOT` → `node_modules/@wavemaker/react-runtime`
+ * Foundation: `WM_FOUNDATION_CSS_SOURCE` → `WM_FOUNDATION_CSS_ROOT` → `node_modules` packages
+ */
+function resolveRoots(cwd = process.cwd()) {
+    const projectRoot = cwd;
+    let reactRuntime = null;
+    const srcRt = process.env.WM_REACT_RUNTIME_SOURCE?.trim();
+    if (srcRt && existsDir(srcRt)) {
+        reactRuntime = { path: node_path_1.default.resolve(srcRt), resolution: "WM_REACT_RUNTIME_SOURCE" };
+    }
+    else {
+        const envRt = process.env.WM_REACT_RUNTIME_ROOT?.trim();
+        if (envRt && existsDir(envRt)) {
+            reactRuntime = { path: node_path_1.default.resolve(envRt), resolution: "WM_REACT_RUNTIME_ROOT" };
+        }
+        else {
+            const d = resolvePackageDir(projectRoot, RUNTIME_PKG);
+            if (d)
+                reactRuntime = { path: d, resolution: `node_modules:${RUNTIME_PKG}` };
+        }
+    }
+    let foundationCss = null;
+    const srcFd = process.env.WM_FOUNDATION_CSS_SOURCE?.trim();
+    if (srcFd && existsDir(srcFd)) {
+        foundationCss = {
+            path: node_path_1.default.resolve(srcFd),
+            resolution: "WM_FOUNDATION_CSS_SOURCE",
+            packageName: "(WM_FOUNDATION_CSS_SOURCE)",
+        };
+    }
+    else {
+        const envFd = process.env.WM_FOUNDATION_CSS_ROOT?.trim();
+        if (envFd && existsDir(envFd)) {
+            foundationCss = {
+                path: node_path_1.default.resolve(envFd),
+                resolution: "WM_FOUNDATION_CSS_ROOT",
+                packageName: "(WM_FOUNDATION_CSS_ROOT)",
+            };
+        }
+        else {
+            for (const name of FOUNDATION_CANDIDATES) {
+                const d = resolvePackageDir(projectRoot, name);
+                if (d) {
+                    foundationCss = { path: d, resolution: `node_modules:${name}`, packageName: name };
+                    break;
+                }
+            }
+        }
+    }
+    return { projectRoot, reactRuntime, foundationCss };
+}
+/**
+ * Local react-runtime repos often use `src/components`; published packages use `components`.
+ */
+function resolveRuntimeComponentsRoot(runtimeRoot) {
+    const srcComponents = node_path_1.default.join(runtimeRoot, "src", "components");
+    if (existsDir(srcComponents))
+        return srcComponents;
+    return node_path_1.default.join(runtimeRoot, "components");
+}
+/**
+ * Ensure `relativePath` resolves under `root` (no traversal).
+ */
+function safeReadUnderRoot(root, relativePath) {
+    const absRoot = node_path_1.default.resolve(root);
+    const joined = node_path_1.default.resolve(absRoot, relativePath);
+    const rel = node_path_1.default.relative(absRoot, joined);
+    if (rel.startsWith("..") || node_path_1.default.isAbsolute(rel)) {
+        return { ok: false, error: "Path escapes root directory" };
+    }
+    return { ok: true, absolute: joined };
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

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

package/dist/search.d.ts

@@ -0,0 +1,15 @@
+export type ContentMatch = {
+    file: string;
+    line: number;
+    text: string;
+};
+/**
+ * Try ripgrep for fast search; returns null if rg is missing or errors.
+ */
+export declare function searchWithRipgrep(root: string, pattern: string, maxResults: number, pathGlob?: string): ContentMatch[] | null;
+/**
+ * Slow path: walk files under root and scan line-by-line.
+ */
+export declare function searchWithNode(root: string, pattern: string, maxResults: number, pathGlob?: string): Promise<ContentMatch[]>;
+export declare function formatMatches(rootLabel: string, rootPath: string, matches: ContentMatch[]): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAuBF;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,YAAY,EAAE,GAAG,IAAI,CAmBvB;AAuBD;;GAEG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,YAAY,EAAE,CAAC,CAsCzB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAMlG"}

package/dist/search.js

@@ -0,0 +1,130 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchWithRipgrep = searchWithRipgrep;
+exports.searchWithNode = searchWithNode;
+exports.formatMatches = formatMatches;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+const TEXT_EXTENSIONS = new Set([
+    ".ts",
+    ".tsx",
+    ".js",
+    ".jsx",
+    ".mjs",
+    ".cjs",
+    ".json",
+    ".md",
+    ".less",
+    ".css",
+    ".scss",
+    ".svg",
+    ".html",
+]);
+function isTextish(file) {
+    const ext = file.slice(file.lastIndexOf("."));
+    return TEXT_EXTENSIONS.has(ext.toLowerCase()) || !ext.includes(".");
+}
+/**
+ * Try ripgrep for fast search; returns null if rg is missing or errors.
+ */
+function searchWithRipgrep(root, pattern, maxResults, pathGlob) {
+    const args = ["--line-number", "--no-heading", "--smart-case"];
+    if (pathGlob && pathGlob.length > 0) {
+        args.push("--glob", pathGlob);
+    }
+    args.push(pattern, root);
+    try {
+        const out = (0, node_child_process_1.execFileSync)("rg", args, {
+            encoding: "utf8",
+            maxBuffer: 32 * 1024 * 1024,
+        });
+        return parseRgOutput(out, root, maxResults);
+    }
+    catch (e) {
+        const err = e;
+        if (err.status === 1 && typeof err.stdout === "string") {
+            return parseRgOutput(err.stdout, root, maxResults);
+        }
+        return null;
+    }
+}
+function parseRgOutput(out, root, maxResults) {
+    const lines = out.split(/\r?\n/).filter(Boolean);
+    const matches = [];
+    const absRoot = node_path_1.default.resolve(root);
+    for (const line of lines) {
+        const m = /^(.+?):(\d+):(.*)$/.exec(line);
+        if (!m)
+            continue;
+        let filePath = m[1];
+        const absFile = node_path_1.default.resolve(filePath);
+        filePath = node_path_1.default.relative(absRoot, absFile).replace(/\\/g, "/");
+        if (filePath.startsWith(".."))
+            continue;
+        matches.push({
+            file: filePath,
+            line: Number(m[2]),
+            text: m[3],
+        });
+        if (matches.length >= maxResults)
+            break;
+    }
+    return matches;
+}
+/**
+ * Slow path: walk files under root and scan line-by-line.
+ */
+async function searchWithNode(root, pattern, maxResults, pathGlob) {
+    const globPat = pathGlob && pathGlob.length > 0 ? pathGlob : "**/*";
+    const files = await (0, fast_glob_1.default)(globPat, {
+        cwd: root,
+        onlyFiles: true,
+        dot: false,
+        ignore: ["**/node_modules/**"],
+        followSymbolicLinks: false,
+    });
+    let regex;
+    try {
+        regex = new RegExp(pattern, "i");
+    }
+    catch {
+        regex = new RegExp(pattern.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
+    }
+    const matches = [];
+    const maxFiles = 4000;
+    for (let i = 0; i < files.length && i < maxFiles; i++) {
+        const rel = files[i];
+        if (!isTextish(rel))
+            continue;
+        const full = `${root}/${rel}`.replace(/\\/g, "/");
+        let content;
+        try {
+            content = node_fs_1.default.readFileSync(full, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const lines = content.split(/\r?\n/);
+        for (let li = 0; li < lines.length; li++) {
+            if (regex.test(lines[li])) {
+                matches.push({ file: rel.replace(/\\/g, "/"), line: li + 1, text: lines[li] });
+                if (matches.length >= maxResults)
+                    return matches;
+            }
+        }
+    }
+    return matches;
+}
+function formatMatches(rootLabel, rootPath, matches) {
+    if (matches.length === 0) {
+        return `No matches in ${rootLabel} (${rootPath}).`;
+    }
+    const lines = matches.map((m) => `${m.file}:${m.line}: ${m.text}`);
+    return [`${rootLabel} (${rootPath})`, "", ...lines].join("\n");
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":";;;;;AAmCA,8CAwBC;AA0BD,wCA2CC;AAED,sCAMC;AAxID,2DAAkD;AAClD,sDAAyB;AACzB,0DAA6B;AAC7B,0DAA2B;AAQ3B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;IACP,MAAM;IACN,OAAO;IACP,MAAM;IACN,OAAO;CACR,CAAC,CAAC;AAEH,SAAS,SAAS,CAAC,IAAY;IAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,QAAiB;IAEjB,MAAM,IAAI,GAAG,CAAC,eAAe,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IAC/D,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAA,iCAAY,EAAC,IAAI,EAAE,IAAI,EAAE;YACnC,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,aAAa,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAU,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,CAAyC,CAAC;QACtD,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QACrD,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,GAAW,EAAE,IAAY,EAAE,UAAkB;IAClE,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,OAAO,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,QAAQ,GAAG,mBAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/D,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACxC,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAClB,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;SACX,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;YAAE,MAAM;IAC1C,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,cAAc,CAClC,IAAY,EACZ,OAAe,EACf,UAAkB,EAClB,QAAiB;IAEjB,MAAM,OAAO,GAAG,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAE,EAAC,OAAO,EAAE;QAC9B,GAAG,EAAE,IAAI;QACT,SAAS,EAAE,IAAI;QACf,GAAG,EAAE,KAAK;QACV,MAAM,EAAE,CAAC,oBAAoB,CAAC;QAC9B,mBAAmB,EAAE,KAAK;KAC3B,CAAC,CAAC;IAEH,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IAED,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QACtD,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;YAAE,SAAS;QAC9B,MAAM,IAAI,GAAG,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,OAAe,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,GAAG,iBAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBAC1B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC/E,IAAI,OAAO,CAAC,MAAM,IAAI,UAAU;oBAAE,OAAO,OAAO,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAgB,aAAa,CAAC,SAAiB,EAAE,QAAgB,EAAE,OAAuB;IACxF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,iBAAiB,SAAS,KAAK,QAAQ,IAAI,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,SAAS,KAAK,QAAQ,GAAG,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjE,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "wavemaker-dev-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for WaveMaker React runtime and foundation-css: search, read props, and tokens from node_modules",
+  "keywords": [
+    "mcp",
+    "wavemaker",
+    "react-runtime",
+    "foundation-css",
+    "modelcontextprotocol"
+  ],
+  "license": "MIT",
+  "author": "Naresh Ravulapalli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nareshr500/wavemaker-dev-mcp.git"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "bin": {
+    "wavemaker-dev-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postbuild": "chmod +x dist/index.js",
+    "start": "node dist/index.js",
+    "test": "playwright test",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "fast-glob": "^3.3.3",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.59.0",
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2"
+  }
+}