@utilix-tech/mcp 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,9 @@
 
 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.11.0
+- Added robots.txt Validator (`validate_robots_txt`) and Credit Card Number Validator (`validate_card_number`).
+
 ## 0.10.0
 - Added Sitemap.xml Validator (`validate_sitemap`).
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 107 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 109 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.
 
@@ -145,13 +145,14 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `date_diff` | Calculate the difference between two dates |
 | `convert_timezone` | Convert a date/time between timezones |
 
-### Units (2 tools)
+### Units (3 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
 | `px_to_units` | Convert pixels to rem, em, pt, and vw |
+| `validate_card_number` | Validate a credit card number via the Luhn checksum and detect its network |
 
-### API / Network (7 tools)
+### API / Network (8 tools)
 | Tool | Description |
 |------|-------------|
 | `decode_jwt` | Decode a JWT: header, payload, and expiry |
@@ -161,6 +162,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `cors_headers` | Generate CORS response headers for a configuration |
 | `parse_har` | Parse a DevTools .har network export into requests and summary stats |
 | `validate_sitemap` | Validate a sitemap.xml or sitemap index against the sitemaps.org protocol |
+| `validate_robots_txt` | Validate a robots.txt file: User-agent groups, rules, and directive syntax |
 
 ### Color (4 tools)
 | Tool | Description |

package/dist/index.js

@@ -1579,6 +1579,169 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _KNOWN_ROBOTS_DIRECTIVES = /* @__PURE__ */ new Set(["user-agent", "disallow", "allow", "sitemap", "crawl-delay", "host"]);
+function _validateRobotsTxt(text2) {
+  if (!text2 || !text2.trim()) return { error: "Input is empty" };
+  const lines = text2.split("\n");
+  const issues = [];
+  const groups = [];
+  const sitemaps = [];
+  let currentGroup = null;
+  for (let i = 0; i < lines.length; i++) {
+    const rawLine = lines[i];
+    const lineNum = i + 1;
+    const commentIdx = rawLine.indexOf("#");
+    const line = (commentIdx >= 0 ? rawLine.slice(0, commentIdx) : rawLine).trim();
+    if (!line) continue;
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) {
+      issues.push({ severity: "error", line: lineNum, message: `Malformed line (missing ':'): "${line}"` });
+      continue;
+    }
+    const directive = line.slice(0, colonIdx).trim().toLowerCase();
+    const value = line.slice(colonIdx + 1).trim();
+    if (!_KNOWN_ROBOTS_DIRECTIVES.has(directive)) {
+      issues.push({ severity: "warning", line: lineNum, message: `Unknown directive "${directive}"` });
+      continue;
+    }
+    if (directive === "sitemap") {
+      if (!/^https?:\/\//i.test(value)) {
+        issues.push({ severity: "error", line: lineNum, message: `Sitemap URL "${value}" must be absolute (start with http:// or https://)` });
+      }
+      sitemaps.push(value);
+      continue;
+    }
+    if (directive === "user-agent") {
+      if (!value) {
+        issues.push({ severity: "error", line: lineNum, message: "User-agent directive is missing a value" });
+      }
+      if (currentGroup && currentGroup.rules.length === 0 && currentGroup.crawlDelay === void 0) {
+        currentGroup.userAgents.push(value);
+      } else {
+        currentGroup = { userAgents: [value], rules: [], line: lineNum };
+        groups.push(currentGroup);
+      }
+      continue;
+    }
+    if (!currentGroup) {
+      issues.push({ severity: "error", line: lineNum, message: `"${directive}" directive found before any User-agent line` });
+      continue;
+    }
+    if (directive === "disallow" || directive === "allow") {
+      if (value !== "" && !value.startsWith("/") && !value.startsWith("*")) {
+        issues.push({ severity: "warning", line: lineNum, message: `${directive === "disallow" ? "Disallow" : "Allow"} value "${value}" should start with "/" (or be empty)` });
+      }
+      if (currentGroup.rules.some((r) => r.type === directive && r.value === value)) {
+        issues.push({ severity: "warning", line: lineNum, message: `Duplicate ${directive} rule for "${value}" in this group` });
+      }
+      currentGroup.rules.push({ type: directive, value, line: lineNum });
+    } else if (directive === "crawl-delay") {
+      const n = Number(value);
+      if (Number.isNaN(n) || n < 0) {
+        issues.push({ severity: "error", line: lineNum, message: `Crawl-delay "${value}" must be a non-negative number` });
+      } else {
+        currentGroup.crawlDelay = n;
+      }
+    }
+  }
+  if (groups.length === 0) {
+    issues.push({ severity: "error", line: 1, message: "No User-agent groups found" });
+  }
+  const seenUA = /* @__PURE__ */ new Map();
+  for (const g of groups) {
+    for (const ua of g.userAgents) {
+      const key = ua.toLowerCase();
+      const firstLine = seenUA.get(key);
+      if (firstLine !== void 0) {
+        issues.push({ severity: "warning", line: g.line, message: `Duplicate User-agent "${ua}" (first seen on line ${firstLine})` });
+      } else {
+        seenUA.set(key, g.line);
+      }
+    }
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { groups, sitemaps, issues, valid };
+}
+server.tool(
+  "validate_robots_txt",
+  "Validate a robots.txt file: parse it into User-agent groups and flag structural mistakes \u2014 directives before any User-agent, unknown directives, non-absolute Sitemap URLs, malformed Crawl-delay values, missing leading slashes, and duplicate rules.",
+  { text: z.string().describe("The robots.txt file contents") },
+  async ({ text: robotsTxt }) => {
+    const result = _validateRobotsTxt(robotsTxt);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+var _CARD_NETWORK_RULES = [
+  { name: "American Express", lengths: [15], test: (d) => /^3[47]/.test(d) },
+  { name: "Diners Club", lengths: [14], test: (d) => /^3(?:0[0-5]|[68])/.test(d) },
+  {
+    name: "Discover",
+    lengths: [16, 19],
+    test: (d) => /^(?:6011|65|64[4-9])/.test(d) || /^622(?:12[6-9]|1[3-9]\d|[2-8]\d{2}|9[01]\d|92[0-5])/.test(d)
+  },
+  { name: "JCB", lengths: [16], test: (d) => /^35(?:2[89]|[3-8]\d)/.test(d) },
+  {
+    name: "Mastercard",
+    lengths: [16],
+    test: (d) => {
+      const two = parseInt(d.slice(0, 2), 10);
+      const four = parseInt(d.slice(0, 4), 10);
+      return two >= 51 && two <= 55 || four >= 2221 && four <= 2720;
+    }
+  },
+  { name: "Maestro", lengths: [12, 13, 14, 15, 16, 17, 18, 19], test: (d) => /^(?:50|5[6-8]|6304|6390|67)/.test(d) },
+  { name: "UnionPay", lengths: [16, 17, 18, 19], test: (d) => /^62/.test(d) },
+  { name: "Visa", lengths: [13, 16, 19], test: (d) => /^4/.test(d) }
+];
+function _luhnCheck(digits) {
+  let sum = 0;
+  let shouldDouble = false;
+  for (let i = digits.length - 1; i >= 0; i--) {
+    let d = parseInt(digits[i], 10);
+    if (shouldDouble) {
+      d *= 2;
+      if (d > 9) d -= 9;
+    }
+    sum += d;
+    shouldDouble = !shouldDouble;
+  }
+  return sum % 10 === 0;
+}
+function _detectCardNetwork(digits) {
+  for (const rule of _CARD_NETWORK_RULES) {
+    if (rule.lengths.includes(digits.length) && rule.test(digits)) return rule.name;
+  }
+  return null;
+}
+function _formatCardNumber(digits, network) {
+  if (network === "American Express") {
+    return `${digits.slice(0, 4)} ${digits.slice(4, 10)} ${digits.slice(10)}`.trim();
+  }
+  return digits.match(/.{1,4}/g)?.join(" ") ?? digits;
+}
+function _validateCardNumber(input) {
+  if (!input || !input.trim()) return { error: "Input is empty" };
+  const digits = input.replace(/[\s-]/g, "");
+  if (!/^\d+$/.test(digits)) return { error: "Card number must contain only digits, spaces, or hyphens" };
+  if (digits.length < 12 || digits.length > 19) {
+    return { error: `Card number length (${digits.length}) is outside the valid range of 12-19 digits` };
+  }
+  const valid = _luhnCheck(digits);
+  const network = _detectCardNetwork(digits);
+  const formatted = _formatCardNumber(digits, network);
+  return { valid, network, length: digits.length, formatted };
+}
+server.tool(
+  "validate_card_number",
+  "Validate a credit card number via the Luhn checksum and detect its network (Visa, Mastercard, American Express, Discover, Diners Club, JCB, Maestro, UnionPay) from its prefix and length. No card data is stored or transmitted.",
+  { number: z.string().describe("The card number, digits with optional spaces or hyphens") },
+  async ({ number }) => {
+    const result = _validateCardNumber(number);
+    if ("error" in result) return errText(result);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
 server.tool(
   "format_ndjson",
   "Validate newline-delimited JSON (NDJSON/JSON Lines), report per-line errors, and pretty-print each valid line.",

package/package.json

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