@maz-ui/mcp 5.1.0 → 5.2.0-beta.0

package/README.md

@@ -7,15 +7,18 @@ MCP server and CLI that give AI coding agents (Claude Code, Cursor, GitHub Copil
 At the root of a project that uses maz-ui:
 
 ```bash
+pnpm add -D @maz-ui/mcp   # optional, for a fast start of the server
 npx @maz-ui/mcp init
 ```
 
+When the project installs `@maz-ui/mcp`, the MCP configs start the installed version through your package manager (`pnpm exec maz-ui-mcp`, `yarn run maz-ui-mcp`, `npx --no-install maz-ui-mcp`...), in about a second and at the version of your lockfile. Otherwise they run `npx -y @maz-ui/mcp@<version>`, pinned.
+
 It detects your agents and configures them without touching your own instructions:
 
 - Claude Code: `.claude/rules/maz-ui.md` (rules, always loaded) and `.mcp.json`
 - Cursor, Copilot, Codex, Windsurf...: a delimited `maz-ui` section in `AGENTS.md`, and `.cursor/mcp.json` / `.vscode/mcp.json`
 
-Options: `--targets claude,agents-md,cursor,vscode`, `--no-rules` (MCP server only), `--no-mcp`, `--dry-run`, `--remove`. With Nuxt, the `mazUi.agents` option of `@maz-ui/nuxt` registers the MCP server of the detected agents automatically in development.
+Options: `--targets claude,agents-md,cursor,vscode`, `--no-rules` (MCP server only), `--no-mcp`, `--dry-run`, `--remove`. In a project without maz-ui (`@maz-ui/utils` or `@maz-ui/node` only), `init` only registers the MCP server, with the docs bundled in `@maz-ui/mcp`. With Nuxt, the `mazUi.agents` option of `@maz-ui/nuxt` registers the MCP server of the detected agents automatically in development.
 
 To use it without writing anything in your projects, register the server once for your user: `claude mcp add maz-ui --scope user -- npx -y @maz-ui/mcp@latest` (its instructions carry the maz-ui rules), or install the Claude Code plugin below.
 
@@ -36,7 +39,7 @@ Prompts: `build`, `audit`, `setup`. The server serves the docs shipped in the ma
 
 ## Manual configuration
 
-Start the server with `npx -y @maz-ui/mcp@latest`:
+Start the server with the installed package (`pnpm exec maz-ui-mcp`), or with `npx -y @maz-ui/mcp@latest` without installing anything (prefer a pinned version in a project: with a dist-tag, npx queries the registry at every start):
 
 ```json
 {
@@ -59,6 +62,10 @@ Claude Code users can also install the plugin (skill, MCP server and review hook
 /plugin install maz-ui@maz-ui
 ```
 
+## Troubleshooting
+
+`connection timed out after 30000ms` in Claude Code: the first `npx -y` download exceeded the start timeout, usually behind a slow registry. Install `@maz-ui/mcp` in the project and run `init` again, pin a version (`npx -y @maz-ui/mcp@5.1.0`), or raise the timeout: `MCP_TIMEOUT=60000 claude`.
+
 ## CLI
 
 ```bash

package/dist/chunks/files.mjs

@@ -0,0 +1,70 @@
+import { readFileSync, existsSync, statSync } from 'node:fs';
+import { dirname, join, relative, isAbsolute, resolve } from 'node:path';
+import { g as glob } from '../shared/mcp.Ccxm-Aoc.mjs';
+import { filterBySeverity, reviewCode } from './index.mjs';
+import 'fs';
+import 'path';
+import 'url';
+import 'module';
+import '../shared/mcp.D3_Fk0U3.mjs';
+import 'node:buffer';
+import 'node:util';
+import 'node:child_process';
+import 'node:process';
+import 'tty';
+import 'node:tty';
+import 'node:crypto';
+import 'node:url';
+
+const REVIEWABLE_EXTENSIONS = ["vue", "ts", "tsx", "js", "jsx", "mjs", "mts", "css", "scss", "pcss", "postcss"];
+const MAX_REVIEWED_FILES = 200;
+function detectFramework(fromDirectory) {
+  let directory = fromDirectory;
+  for (; ; ) {
+    if (["nuxt.config.ts", "nuxt.config.js", "nuxt.config.mjs"].some((file) => existsSync(join(directory, file))))
+      return "nuxt";
+    if (existsSync(join(directory, "package.json")))
+      return "vue";
+    const parent = dirname(directory);
+    if (parent === directory)
+      return "vue";
+    directory = parent;
+  }
+}
+async function expandPaths(patterns, cwd) {
+  const files = /* @__PURE__ */ new Set();
+  const globs = [];
+  for (const pattern of patterns) {
+    const absolute = isAbsolute(pattern) ? pattern : resolve(cwd, pattern);
+    if (existsSync(absolute) && statSync(absolute).isFile())
+      files.add(absolute);
+    else if (existsSync(absolute) && statSync(absolute).isDirectory())
+      globs.push(`${relative(cwd, absolute) || "."}/**/*.{${REVIEWABLE_EXTENSIONS.join(",")}}`);
+    else
+      globs.push(pattern);
+  }
+  if (globs.length > 0) {
+    const matches = await glob(globs, { cwd, absolute: true, ignore: ["**/node_modules/**", "**/dist/**", "**/.nuxt/**", "**/.output/**", "**/coverage/**"] });
+    for (const match of matches) files.add(match);
+  }
+  return [...files].filter((file) => REVIEWABLE_EXTENSIONS.includes(file.split(".").pop() ?? "")).sort();
+}
+function displayPath(cwd, file) {
+  const path = relative(cwd, file);
+  return path && !path.startsWith("..") && !isAbsolute(path) ? path : file;
+}
+async function reviewFiles(patterns, { knowledge, cwd, framework, minSeverity = "info" }) {
+  const files = await expandPaths(patterns, cwd);
+  return {
+    truncated: files.length > MAX_REVIEWED_FILES,
+    reviews: files.slice(0, MAX_REVIEWED_FILES).map((file) => ({
+      file: displayPath(cwd, file),
+      findings: filterBySeverity(
+        reviewCode(readFileSync(file, "utf8"), { knowledge, filename: file, framework: framework ?? detectFramework(dirname(file)) }),
+        minSeverity
+      )
+    }))
+  };
+}
+
+export { MAX_REVIEWED_FILES, REVIEWABLE_EXTENSIONS, detectFramework, displayPath, expandPaths, reviewFiles };