@utilix-tech/mcp 0.9.0 → 0.10.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.10.0
+- Added Sitemap.xml Validator (`validate_sitemap`).
+
 ## 0.9.0
 - Added ID3 Tag Reader and .env.example Diff Checker.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 106 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 107 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.
 
@@ -151,7 +151,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `convert_bytes` | Convert between B, KB, MB, GB, TB, KiB, MiB, GiB, TiB |
 | `px_to_units` | Convert pixels to rem, em, pt, and vw |
 
-### API / Network (6 tools)
+### API / Network (7 tools)
 | Tool | Description |
 |------|-------------|
 | `decode_jwt` | Decode a JWT: header, payload, and expiry |
@@ -160,6 +160,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `curl_to_code` | Convert a cURL command to fetch, axios, Python, Go, PHP, or Ruby |
 | `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 |
 
 ### Color (4 tools)
 | Tool | Description |

package/dist/index.js

@@ -1479,6 +1479,106 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _SITEMAP_VALID_CHANGEFREQ = /* @__PURE__ */ new Set(["always", "hourly", "daily", "weekly", "monthly", "yearly", "never"]);
+function _sitemapLineNumber(xml, index) {
+  let line = 1;
+  for (let i = 0; i < index; i++) {
+    if (xml[i] === "\n") line++;
+  }
+  return line;
+}
+function _extractSitemapTag(block, tag) {
+  const m = block.match(new RegExp(`<${tag}[^>]*>([\\s\\S]*?)</${tag}>`, "i"));
+  return m ? m[1].trim() : void 0;
+}
+function _isValidW3CDatetime(s) {
+  return /^\d{4}(-\d{2}(-\d{2}(T\d{2}:\d{2}(:\d{2}(\.\d+)?)?(Z|[+-]\d{2}:\d{2}))?)?)?$/.test(s);
+}
+function _isAbsoluteHttpUrl(s) {
+  return /^https?:\/\//i.test(s);
+}
+function _validateSitemap(xml) {
+  if (!xml || !xml.trim()) return { error: "Input is empty" };
+  const trimmed = xml.trim();
+  const issues = [];
+  if (!/^\s*<\?xml/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: 'Missing XML declaration (<?xml version="1.0" encoding="UTF-8"?>)' });
+  }
+  const isUrlset = /<urlset[\s>]/i.test(trimmed);
+  const isSitemapIndex = /<sitemapindex[\s>]/i.test(trimmed);
+  if (!isUrlset && !isSitemapIndex) {
+    return { error: "Not a valid sitemap: root element must be <urlset> or <sitemapindex>" };
+  }
+  if (isUrlset && isSitemapIndex) {
+    return { error: "Ambiguous file: contains both <urlset> and <sitemapindex> root elements" };
+  }
+  const type = isUrlset ? "urlset" : "sitemapindex";
+  if (isUrlset && !/xmlns\s*=\s*["']http:\/\/www\.sitemaps\.org\/schemas\/sitemap\/0\.9["']/i.test(trimmed)) {
+    issues.push({ severity: "warning", line: 1, message: "Missing or non-standard xmlns namespace (expected http://www.sitemaps.org/schemas/sitemap/0.9)" });
+  }
+  const blockTag = isUrlset ? "url" : "sitemap";
+  const blockRe = new RegExp(`<${blockTag}>([\\s\\S]*?)</${blockTag}>`, "gi");
+  const seenLocs = /* @__PURE__ */ new Set();
+  const entries = [];
+  let match;
+  while ((match = blockRe.exec(trimmed)) !== null) {
+    const block = match[1];
+    const line = _sitemapLineNumber(trimmed, match.index);
+    const loc = _extractSitemapTag(block, "loc");
+    if (!loc) {
+      issues.push({ severity: "error", line, message: `<${blockTag}> entry is missing required <loc>` });
+      continue;
+    }
+    if (!_isAbsoluteHttpUrl(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> must be an absolute URL starting with http:// or https://` });
+    }
+    if (/&(?!amp;|lt;|gt;|apos;|quot;|#\d+;)/.test(loc)) {
+      issues.push({ severity: "error", line, message: `<loc>${loc}</loc> contains an unescaped '&' (use &amp; instead)` });
+    }
+    if (seenLocs.has(loc)) {
+      issues.push({ severity: "warning", line, message: `Duplicate <loc>${loc}</loc>` });
+    }
+    seenLocs.add(loc);
+    const lastmod = _extractSitemapTag(block, "lastmod");
+    if (lastmod !== void 0 && !_isValidW3CDatetime(lastmod)) {
+      issues.push({ severity: "warning", line, message: `<lastmod>${lastmod}</lastmod> is not a valid W3C datetime` });
+    }
+    if (type === "urlset") {
+      const changefreq = _extractSitemapTag(block, "changefreq");
+      if (changefreq !== void 0 && !_SITEMAP_VALID_CHANGEFREQ.has(changefreq.toLowerCase())) {
+        issues.push({ severity: "error", line, message: `<changefreq>${changefreq}</changefreq> must be one of: ${[..._SITEMAP_VALID_CHANGEFREQ].join(", ")}` });
+      }
+      const priority = _extractSitemapTag(block, "priority");
+      if (priority !== void 0) {
+        const p = Number(priority);
+        if (Number.isNaN(p) || p < 0 || p > 1) {
+          issues.push({ severity: "error", line, message: `<priority>${priority}</priority> must be a number between 0.0 and 1.0` });
+        }
+      }
+      entries.push({ loc, lastmod, changefreq, priority, line });
+    } else {
+      entries.push({ loc, lastmod, line });
+    }
+  }
+  if (entries.length === 0) {
+    issues.push({ severity: "error", line: 1, message: `No <${blockTag}> entries found` });
+  }
+  if (type === "urlset" && entries.length > 5e4) {
+    issues.push({ severity: "error", line: 1, message: `Sitemap contains ${entries.length} URLs, exceeding the 50,000 URL limit per the sitemaps.org spec` });
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { type, urlCount: entries.length, entries, issues, valid };
+}
+server.tool(
+  "validate_sitemap",
+  "Validate a sitemap.xml (urlset) or sitemap index (sitemapindex) against the sitemaps.org protocol: required <loc>, absolute URLs, valid <changefreq>/<priority>/<lastmod> values, the 50,000-URL limit, and duplicate entries.",
+  { xml: z.string().describe("The sitemap.xml or sitemap index XML contents") },
+  async ({ xml }) => {
+    const result = _validateSitemap(xml);
+    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,7 +1,7 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.9.0",
-  "description": "MCP server exposing 106 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
+  "version": "0.10.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",
   "homepage": "https://utilix.tech/mcp",