@utilix-tech/mcp 0.66.0 → 0.68.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.68.0
+- Add `build_robots_meta_tag`, `parse_robots_meta_tag` tools: build a `<meta name="robots" content="...">` tag from the same directive vocabulary as X-Robots-Tag, optionally scoped to a crawler via the name attribute, or parse an existing tag into the same shape.
+- Add `extract_svg_sprite_symbols` tool: parse an SVG sprite sheet's `<symbol>` definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste `<use href="#id"></use>` usage snippet.
+
+## 0.67.0
+- Add `analyze_regex_groups` tool: parse a regex pattern's capture groups (numbered and named) and backreferences, flagging any backreference pointing at a group that doesn't exist or hasn't finished being defined yet at that point in the pattern.
+
 ## 0.66.0
 - Add `build_x_robots_tag`, `parse_x_robots_tag` tools: build an X-Robots-Tag response header from flag directives (noindex, nofollow, etc.) plus max-snippet/max-image-preview/max-video-preview/unavailable_after value directives, optionally scoped to a crawler user-agent, or parse an existing header into the same shape.
 - Add `lookup_websocket_opcode`, `list_websocket_opcodes` tools: look up what a WebSocket frame opcode means per RFC 6455's 4-bit opcode space, or list every opcode.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 227 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 231 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
 
 No API key required. All tools run locally. Requires Node.js 18 or later.
 
@@ -205,7 +205,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `plan_debt_payoff` | Simulate paying off a list of debts under both the snowball (smallest balance first) and avalanche (highest rate first) strategies given a fixed extra monthly payment, and compare months to payoff and total interest |
 | `calculate_loan_refinance` | Compare a current loan's remaining payments against a new refinanced loan on the same outstanding balance, and compute the monthly savings and the break-even month where cumulative savings recoup the closing costs |
 
-### API / Network (44 tools)
+### API / Network (48 tools)
 | Tool | Description |
 |------|-------------|
 | `decode_jwt` | Decode a JWT: header, payload, and expiry |
@@ -254,6 +254,8 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `parse_x_robots_tag` | Parse an existing X-Robots-Tag header value into the same shape |
 | `lookup_websocket_opcode` | Look up what a WebSocket frame opcode means, per RFC 6455's 4-bit opcode space |
 | `list_websocket_opcodes` | List every WebSocket frame opcode (0x0-0xF) |
+| `build_robots_meta_tag` | Build a `<meta name="robots" content="...">` tag from directives (noindex, nofollow, max-snippet, etc.), the same vocabulary as X-Robots-Tag, optionally scoped to a crawler via the name attribute |
+| `parse_robots_meta_tag` | Parse an existing robots meta tag (or bare content value) into the same shape |
 
 ### Color (4 tools)
 | Tool | Description |
@@ -263,7 +265,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `color_palette` | Generate a color palette from a base color |
 | `color_shades` | Generate shades or tints from a base color |
 
-### Code (16 tools)
+### Code (18 tools)
 | Tool | Description |
 |------|-------------|
 | `format_sql` | Format a SQL query with proper indentation |
@@ -276,12 +278,14 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `lookup_mime` | Look up the MIME type for a file extension, or the extension(s) for a MIME type |
 | `parse_github_url` | Parse a github.com URL (repo, pull request, issue, commit, file, or release) into structured components |
 | `detect_redos` | Statically flag catastrophic-backtracking (ReDoS) risk in a regex: nested quantifiers, overlapping alternation, adjacent overlapping quantifiers |
+| `analyze_regex_groups` | Parse a regex's capture groups (numbered and named) and backreferences, flagging a backreference pointing at a group that doesn't exist or hasn't finished being defined yet |
 | `lint_conventional_commit` | Lint a commit message against the Conventional Commits v1.0.0 spec: header format, blank-line separation, footer tokens, and BREAKING CHANGE casing |
 | `test_gitignore_patterns` | Test a list of paths against a .gitignore file's patterns, following git's last-match-wins and negation rules |
 | `validate_editorconfig` | Validate an .editorconfig file: root flag, glob sections, and structural mistakes against the EditorConfig spec |
 | `validate_tsconfig` | Validate a tsconfig.json file (JSONC-aware): unknown keys, unknown compilerOptions, and type mismatches |
 | `validate_package_exports` | Validate a package.json "exports" field: dual-package (ESM/CJS) misconfigurations like a missing default fallback or a require/import pointing at the wrong extension |
 | `audit_dependency_ranges` | Classify each package.json dependency's version range type and flag wildcard ranges, the "latest" tag, git/URL/file/link dependencies, and packages listed with conflicting or redundant ranges across sections |
+| `extract_svg_sprite_symbols` | Parse an SVG sprite sheet's `<symbol>` definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste `<use href="#id"></use>` usage snippet |
 
 ### Data (16 tools)
 | Tool | Description |

package/dist/index.js

@@ -4318,6 +4318,123 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _analyzeRegexGroupsMcp(pattern) {
+  let valid = true;
+  let compileError;
+  try {
+    new RegExp(pattern);
+  } catch (e) {
+    valid = false;
+    compileError = e instanceof Error ? e.message : String(e);
+  }
+  const groups = [];
+  const openStack = [];
+  const backreferences = [];
+  const issues = [];
+  let groupCount = 0;
+  let inClass = false;
+  for (let i = 0; i < pattern.length; i++) {
+    const ch = pattern[i];
+    if (ch === "\\" && i + 1 < pattern.length) {
+      const next = pattern[i + 1];
+      if (!inClass && /[1-9]/.test(next)) {
+        let j = i + 1;
+        while (j < pattern.length && /[0-9]/.test(pattern[j])) j++;
+        const raw = pattern.slice(i, j);
+        const target = parseInt(pattern.slice(i + 1, j), 10);
+        backreferences.push({ raw, target, start: i, resolved: false, definedBeforeUse: false });
+        i = j - 1;
+        continue;
+      }
+      if (!inClass && next === "k" && pattern[i + 2] === "<") {
+        const close = pattern.indexOf(">", i + 3);
+        if (close !== -1) {
+          const name = pattern.slice(i + 3, close);
+          const raw = pattern.slice(i, close + 1);
+          backreferences.push({ raw, target: name, start: i, resolved: false, definedBeforeUse: false });
+          i = close;
+          continue;
+        }
+      }
+      i++;
+      continue;
+    }
+    if (ch === "[" && !inClass) {
+      inClass = true;
+      continue;
+    }
+    if (ch === "]" && inClass) {
+      inClass = false;
+      continue;
+    }
+    if (inClass) continue;
+    if (ch === "(") {
+      if (pattern[i + 1] === "?") {
+        const c2 = pattern[i + 2];
+        if (c2 === ":" || c2 === "=" || c2 === "!") {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<" && (pattern[i + 3] === "=" || pattern[i + 3] === "!")) {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<") {
+          const close = pattern.indexOf(">", i + 3);
+          const name = close !== -1 ? pattern.slice(i + 3, close) : null;
+          groupCount++;
+          openStack.push({ index: groupCount, name, start: i });
+          if (close !== -1) i = close;
+          continue;
+        }
+        openStack.push({ index: -1, name: null, start: i });
+        continue;
+      }
+      groupCount++;
+      openStack.push({ index: groupCount, name: null, start: i });
+      continue;
+    }
+    if (ch === ")") {
+      const open = openStack.pop();
+      if (open && open.index !== -1) {
+        groups.push({ index: open.index, name: open.name, start: open.start, end: i });
+      }
+      continue;
+    }
+  }
+  for (const open of openStack) {
+    if (open.index !== -1) groups.push({ index: open.index, name: open.name, start: open.start, end: -1 });
+  }
+  groups.sort((a, b) => a.index - b.index);
+  const byIndex = new Map(groups.map((g) => [g.index, g]));
+  const byName = new Map(groups.filter((g) => g.name !== null).map((g) => [g.name, g]));
+  for (const b of backreferences) {
+    const g = typeof b.target === "number" ? byIndex.get(b.target) : byName.get(b.target);
+    if (!g) {
+      b.resolved = false;
+      b.definedBeforeUse = false;
+      const label = typeof b.target === "number" ? `group ${b.target}` : `named group "${b.target}"`;
+      issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} points to ${label}, which doesn't exist in this pattern.` });
+    } else {
+      b.resolved = true;
+      b.definedBeforeUse = g.end !== -1 && g.end < b.start;
+      if (!b.definedBeforeUse) {
+        const label = `group ${g.index}${g.name ? ` ("${g.name}")` : ""}`;
+        issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} references ${label}, which hasn't finished being defined yet at that point in the pattern.` });
+      }
+    }
+  }
+  return { pattern, valid, ...compileError ? { compileError } : {}, groups, backreferences, issues };
+}
+server.tool(
+  "analyze_regex_groups",
+  "Parse a regex pattern's capture groups (numbered and named) and backreferences, and flag any backreference pointing at a group that doesn't exist or hasn't finished being defined yet at that point in the pattern (a forward reference or self-reference). Structural, non-AI check. Pass the pattern body only, no delimiters or flags.",
+  { pattern: z.string().describe("The regex pattern body to analyze, e.g. (?<year>\\d{4})-(?<month>\\d{2})\\k<year>") },
+  async ({ pattern }) => {
+    const result = _analyzeRegexGroupsMcp(pattern);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var _CC_NUM_FIELDS_MCP = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
 function _humanizeCacheSecondsMcp(s) {
   if (s === 0) return "0 seconds";
@@ -10751,5 +10868,147 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _buildRobotsMetaTagMcp(options) {
+  const built = _buildXRobotsTagMcp({
+    flags: options?.flags,
+    maxSnippet: options?.maxSnippet,
+    maxImagePreview: options?.maxImagePreview,
+    maxVideoPreview: options?.maxVideoPreview,
+    unavailableAfter: options?.unavailableAfter
+  });
+  if ("error" in built) return built;
+  const name = (typeof options?.name === "string" ? options.name.trim() : "") || "robots";
+  return {
+    content: built.header,
+    name,
+    tag: `<meta name="${name}" content="${built.header}">`,
+    directives: built.directives,
+    notes: built.notes,
+    warnings: built.warnings
+  };
+}
+var _ROBOTS_META_TAG_REGEX_MCP = /<meta\b[^>]*>/i;
+var _ROBOTS_META_NAME_ATTR_REGEX_MCP = /\bname\s*=\s*["']([^"']*)["']/i;
+var _ROBOTS_META_CONTENT_ATTR_REGEX_MCP = /\bcontent\s*=\s*["']([^"']*)["']/i;
+function _parseRobotsMetaTagMcp(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const trimmed = raw.trim();
+  let name = "robots";
+  let content = trimmed;
+  const tagMatch = trimmed.match(_ROBOTS_META_TAG_REGEX_MCP);
+  if (tagMatch) {
+    const nameMatch = tagMatch[0].match(_ROBOTS_META_NAME_ATTR_REGEX_MCP);
+    const contentMatch = tagMatch[0].match(_ROBOTS_META_CONTENT_ATTR_REGEX_MCP);
+    if (!contentMatch) return { error: "Meta tag is missing a content attribute" };
+    if (nameMatch) name = nameMatch[1].trim() || "robots";
+    content = contentMatch[1];
+  }
+  const tokens = content.split(",").map((t) => t.trim()).filter((t) => t !== "");
+  if (tokens.length === 0) return { error: "No directives found" };
+  const flags = [];
+  let maxSnippet;
+  let maxImagePreview;
+  let maxVideoPreview;
+  let unavailableAfter;
+  for (const token of tokens) {
+    const eq = token.indexOf(":");
+    const directiveName = (eq === -1 ? token : token.slice(0, eq)).trim().toLowerCase();
+    const value = eq === -1 ? "" : token.slice(eq + 1).trim();
+    if (eq === -1) {
+      if (!_isXRobotsTagFlagMcp(directiveName)) return { error: `Unrecognized directive "${token}"` };
+      flags.push(directiveName);
+      continue;
+    }
+    if (directiveName === "max-snippet") {
+      const n = Number(value);
+      if (value === "" || !Number.isInteger(n) || n < -1) return { error: `max-snippet value "${value}" is not a valid integer >= -1` };
+      maxSnippet = n;
+    } else if (directiveName === "max-image-preview") {
+      if (!["none", "standard", "large"].includes(value)) return { error: `max-image-preview value "${value}" must be one of "none", "standard", "large"` };
+      maxImagePreview = value;
+    } else if (directiveName === "max-video-preview") {
+      const n = Number(value);
+      if (value === "" || !Number.isInteger(n) || n < -1) return { error: `max-video-preview value "${value}" is not a valid integer >= -1` };
+      maxVideoPreview = n;
+    } else if (directiveName === "unavailable_after") {
+      if (value === "" || Number.isNaN(Date.parse(value))) return { error: `unavailable_after value "${value}" is not a valid, parseable date` };
+      unavailableAfter = value;
+    } else {
+      return { error: `Unrecognized directive "${token}"` };
+    }
+  }
+  return _buildRobotsMetaTagMcp({ flags, maxSnippet, maxImagePreview, maxVideoPreview, unavailableAfter, name });
+}
+server.tool(
+  "build_robots_meta_tag",
+  'Build a <meta name="robots" content="..."> tag from flag directives (noindex, nofollow, noarchive, nosnippet, notranslate, noimageindex, none, all, indexifembedded) plus optional max-snippet, max-image-preview, max-video-preview, and unavailable_after value directives, the exact same directive vocabulary as the X-Robots-Tag header. Scope the tag to a single crawler with name (e.g. "googlebot") instead of the default "robots".',
+  {
+    flags: z.array(z.enum(["noindex", "nofollow", "noarchive", "nosnippet", "notranslate", "noimageindex", "none", "all", "indexifembedded"])).optional().describe("Flag directives to include"),
+    maxSnippet: z.number().int().min(-1).optional().describe("Max text snippet length in characters; 0 shows no snippet, -1 means no limit"),
+    maxImagePreview: z.enum(["none", "standard", "large"]).optional().describe("Max image preview size shown in search results"),
+    maxVideoPreview: z.number().int().min(-1).optional().describe("Max video preview length in seconds; 0 shows no preview, -1 means no limit"),
+    unavailableAfter: z.string().optional().describe("Stop showing this page in search results after this date/time"),
+    name: z.string().optional().describe('Optional crawler name to scope the tag to via its name attribute, e.g. "googlebot" (default "robots")')
+  },
+  async ({ flags, maxSnippet, maxImagePreview, maxVideoPreview, unavailableAfter, name }) => {
+    const result = _buildRobotsMetaTagMcp({ flags, maxSnippet, maxImagePreview, maxVideoPreview, unavailableAfter, name });
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+server.tool(
+  "parse_robots_meta_tag",
+  'Parse an existing <meta name="..." content="..."> robots tag (or a bare content attribute value on its own) into the same shape build_robots_meta_tag returns.',
+  {
+    tag: z.string().min(1).describe("The meta tag (or bare content value) to parse")
+  },
+  async ({ tag }) => {
+    const result = _parseRobotsMetaTagMcp(tag);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+var _SVG_SYMBOL_TAG_REGEX_MCP = /<symbol\b([^>]*)>/gi;
+function _extractSvgAttrMcp(attrs, name) {
+  const match = attrs.match(new RegExp(`\\s${name}\\s*=\\s*["']([^"']*)["']`, "i"));
+  return match ? match[1] : null;
+}
+function _extractSvgSpriteSymbolsMcp(svg) {
+  const trimmed = svg.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const symbols = [];
+  let skippedCount = 0;
+  for (const match of trimmed.matchAll(_SVG_SYMBOL_TAG_REGEX_MCP)) {
+    const attrs = match[1];
+    const id = _extractSvgAttrMcp(attrs, "id");
+    if (!id) {
+      skippedCount++;
+      continue;
+    }
+    symbols.push({
+      id,
+      viewBox: _extractSvgAttrMcp(attrs, "viewBox"),
+      width: _extractSvgAttrMcp(attrs, "width"),
+      height: _extractSvgAttrMcp(attrs, "height"),
+      usageSnippet: `<svg><use href="#${id}"></use></svg>`
+    });
+  }
+  if (symbols.length === 0 && skippedCount === 0) {
+    return { error: "No <symbol> elements found" };
+  }
+  return { symbolCount: symbols.length, symbols, skippedCount };
+}
+server.tool(
+  "extract_svg_sprite_symbols",
+  `Parse an SVG sprite sheet's <symbol> definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste <use href="#id"></use> usage snippet. A symbol with no id is skipped (counted in skippedCount) since it can't be referenced by a <use> element at all.`,
+  {
+    svg: z.string().min(1).describe("The SVG sprite sheet markup")
+  },
+  async ({ svg }) => {
+    const result = _extractSvgSpriteSymbolsMcp(svg);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.66.0",
+  "version": "0.68.0",
   "description": "MCP server exposing 198 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",