@utilix-tech/mcp 0.80.0 → 0.82.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.82.0
+- Add `generate_robots_txt` tool: build a robots.txt file from User-agent groups with Allow/Disallow rules and an optional Crawl-delay, plus a list of Sitemap URLs. The generator-side sibling of `validate_robots_txt`.
+
+## 0.81.0
+- Add `validate_fence_language_tags` tool: scan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tag against a curated list of common syntax-highlighter identifiers.
+- Add `count_sql_placeholders` tool: count positional (`?`, `$1`) and named (`:name`, `@name`) parameter placeholders in a SQL query, flagging mixed styles and numbered-sequence gaps or duplicates.
+
 ## 0.80.0
 - Add `diff_json_patch`, `apply_json_patch` tools: diff two JSON documents into an RFC 6902 JSON Patch operation list (add/remove/replace/move/copy/test), or apply a patch to a target document.
 - Add `parse_connection_string` tool: parse a database connection URI (postgres, mysql, mongodb, redis, amqp, and similar) into its scheme, credentials, hosts, database, and query parameters.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 255 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 258 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.
 
@@ -231,6 +231,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `validate_sitemap` | Validate a sitemap.xml or sitemap index against the sitemaps.org protocol |
 | `split_sitemap` | Split a URL list exceeding the sitemaps.org 50,000-URL cap into multiple sitemap.xml files plus a sitemap index file |
 | `validate_robots_txt` | Validate a robots.txt file: User-agent groups, rules, and directive syntax |
+| `generate_robots_txt` | Generate a robots.txt file from User-agent groups with Allow/Disallow rules and an optional Crawl-delay, plus Sitemap URLs |
 | `parse_user_agent` | Parse a browser User-Agent string into browser, engine, OS, and device type |
 | `build_cache_control` | Build and explain an HTTP Cache-Control response header from directives (max-age, no-store, immutable, etc.) |
 | `build_referrer_policy` | Build and explain an HTTP Referrer-Policy header from one or more fallback-chain policy tokens |
@@ -281,7 +282,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 (22 tools)
+### Code (24 tools)
 | Tool | Description |
 |------|-------------|
 | `format_sql` | Format a SQL query with proper indentation |
@@ -306,6 +307,8 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `extract_markdown_footnotes` | Extract every Markdown-Extra-style footnote reference and definition from a document, flagging references with no matching definition and definitions that are never referenced |
 | `validate_aria` | Parse an HTML snippet and check every role and aria-* attribute against a curated table of WAI-ARIA 1.2 roles: unknown role names, an aria-* attribute not permitted on the given role, and a widget role missing its required aria-* state |
 | `parse_connection_string` | Parse a database connection URI (postgres, mysql, mongodb, redis, amqp, and similar) into its scheme, credentials, hosts, database, and query parameters |
+| `validate_fence_language_tags` | Scan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tag against a curated list of common syntax-highlighter identifiers |
+| `count_sql_placeholders` | Count positional (`?`, `$1`) and named (`:name`, `@name`) parameter placeholders in a SQL query, flagging mixed styles and numbered-sequence gaps or duplicates |
 
 ### Data (16 tools)
 | Tool | Description |

package/dist/index.js

@@ -1895,6 +1895,58 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+function _generateRobotsTxt(groups, sitemaps) {
+  if (!Array.isArray(groups) || groups.length === 0) {
+    return { error: "At least one group with a user-agent is required" };
+  }
+  const lines = [];
+  for (const group of groups) {
+    const userAgents = (group.userAgents ?? []).map((a) => a.trim()).filter(Boolean);
+    if (userAgents.length === 0) return { error: "Each group needs at least one non-empty user-agent" };
+    for (const ua of userAgents) lines.push(`User-agent: ${ua}`);
+    const disallow = group.disallow ?? [];
+    const allow = group.allow ?? [];
+    if (disallow.length === 0 && allow.length === 0) {
+      lines.push("Disallow:");
+    } else {
+      for (const value of disallow) lines.push(`Disallow: ${value}`);
+      for (const value of allow) lines.push(`Allow: ${value}`);
+    }
+    if (group.crawlDelay !== void 0) {
+      if (!Number.isFinite(group.crawlDelay) || group.crawlDelay < 0) {
+        return { error: "crawlDelay must be a non-negative number" };
+      }
+      lines.push(`Crawl-delay: ${group.crawlDelay}`);
+    }
+    lines.push("");
+  }
+  for (const sitemap of sitemaps ?? []) {
+    if (!/^https?:\/\//i.test(sitemap)) {
+      return { error: `Sitemap URL "${sitemap}" must be absolute (start with http:// or https://)` };
+    }
+    lines.push(`Sitemap: ${sitemap}`);
+  }
+  while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+  return { text: lines.join("\n") + "\n" };
+}
+server.tool(
+  "generate_robots_txt",
+  "Generate a robots.txt file from one or more User-agent groups (each with Allow/Disallow rules and an optional Crawl-delay) plus a list of Sitemap URLs. The inverse of validate_robots_txt: a group with no Allow or Disallow rules gets an explicit empty Disallow line, the standard way to allow crawling everything.",
+  {
+    groups: z.array(z.object({
+      userAgents: z.array(z.string()).describe('User-agent tokens for this group, e.g. ["*"] or ["Googlebot"]'),
+      allow: z.array(z.string()).optional().describe('Allow rule paths, e.g. ["/admin/public"]'),
+      disallow: z.array(z.string()).optional().describe('Disallow rule paths, e.g. ["/admin"]'),
+      crawlDelay: z.number().optional().describe("Crawl-delay in seconds for this group")
+    })).describe("User-agent groups to emit, in order"),
+    sitemaps: z.array(z.string()).optional().describe("Absolute sitemap URLs to append as Sitemap directives")
+  },
+  async ({ groups, sitemaps }) => {
+    const result = _generateRobotsTxt(groups, sitemaps);
+    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) },
@@ -12744,5 +12796,368 @@ server.tool(
     return text(JSON.stringify(result, null, 2));
   }
 );
+var _KNOWN_LANGUAGE_TAGS_MCP = /* @__PURE__ */ new Set([
+  "js",
+  "jsx",
+  "mjs",
+  "cjs",
+  "javascript",
+  "ts",
+  "tsx",
+  "typescript",
+  "json",
+  "json5",
+  "jsonc",
+  "jsonl",
+  "ndjson",
+  "yaml",
+  "yml",
+  "toml",
+  "ini",
+  "cfg",
+  "conf",
+  "properties",
+  "env",
+  "dotenv",
+  "html",
+  "htm",
+  "xml",
+  "svg",
+  "xhtml",
+  "css",
+  "scss",
+  "sass",
+  "less",
+  "stylus",
+  "styl",
+  "markdown",
+  "md",
+  "mdx",
+  "bash",
+  "sh",
+  "shell",
+  "zsh",
+  "fish",
+  "console",
+  "powershell",
+  "ps1",
+  "bat",
+  "cmd",
+  "python",
+  "py",
+  "py3",
+  "ipynb",
+  "ruby",
+  "rb",
+  "erb",
+  "php",
+  "java",
+  "kotlin",
+  "kt",
+  "kts",
+  "groovy",
+  "gradle",
+  "swift",
+  "objectivec",
+  "objc",
+  "go",
+  "golang",
+  "rust",
+  "rs",
+  "c",
+  "h",
+  "cpp",
+  "cc",
+  "cxx",
+  "hpp",
+  "c++",
+  "csharp",
+  "cs",
+  "fsharp",
+  "fs",
+  "perl",
+  "pl",
+  "lua",
+  "r",
+  "matlab",
+  "m",
+  "scala",
+  "nim",
+  "zig",
+  "julia",
+  "jl",
+  "haskell",
+  "hs",
+  "elixir",
+  "ex",
+  "exs",
+  "erlang",
+  "erl",
+  "clojure",
+  "clj",
+  "cljs",
+  "dart",
+  "ocaml",
+  "ml",
+  "sql",
+  "mysql",
+  "postgresql",
+  "plsql",
+  "sqlite",
+  "graphql",
+  "gql",
+  "dockerfile",
+  "docker",
+  "makefile",
+  "make",
+  "cmake",
+  "nginx",
+  "apache",
+  "diff",
+  "patch",
+  "git",
+  "http",
+  "proto",
+  "protobuf",
+  "csv",
+  "tsv",
+  "vim",
+  "viml",
+  "tex",
+  "latex",
+  "bibtex",
+  "plaintext",
+  "text",
+  "txt",
+  "nohighlight",
+  "none",
+  "asciidoc",
+  "adoc",
+  "rst",
+  "vue",
+  "svelte",
+  "astro",
+  "wasm",
+  "wat",
+  "handlebars",
+  "hbs",
+  "pug",
+  "jade",
+  "coffee",
+  "coffeescript",
+  "actionscript",
+  "terraform",
+  "tf",
+  "hcl",
+  "puppet",
+  "ansible"
+]);
+function _parseFenceLineMcp(line) {
+  const match = line.match(/^( {0,3})(`{3,}|~{3,})(.*)$/);
+  if (!match) return null;
+  const [, , marker, rest] = match;
+  const char = marker[0];
+  if (char === "`" && rest.includes("`")) return null;
+  return { char, length: marker.length, infoString: rest.trim() };
+}
+function _isClosingFenceMcp(line, fenceChar, fenceLength) {
+  const match = line.match(/^ {0,3}(`+|~+)\s*$/);
+  if (!match) return false;
+  const marker = match[1];
+  return marker[0] === fenceChar && marker.length >= fenceLength;
+}
+function _validateFenceLanguageTagsMcp(markdown) {
+  const lines = markdown.split("\n");
+  const issues = [];
+  let totalFences = 0;
+  let open = null;
+  for (let i = 0; i < lines.length; i++) {
+    const lineNumber = i + 1;
+    const line = lines[i];
+    if (open) {
+      if (_isClosingFenceMcp(line, open.char, open.length)) open = null;
+      continue;
+    }
+    const fence = _parseFenceLineMcp(line);
+    if (!fence) continue;
+    totalFences++;
+    const tag = fence.infoString.split(/\s+/)[0] ?? "";
+    open = { char: fence.char, length: fence.length };
+    if (tag === "") {
+      issues.push({ line: lineNumber, tag, issue: "missing" });
+      continue;
+    }
+    const lower = tag.toLowerCase();
+    if (!_KNOWN_LANGUAGE_TAGS_MCP.has(lower)) {
+      issues.push({ line: lineNumber, tag, issue: "unknown" });
+      continue;
+    }
+    if (tag !== lower) {
+      issues.push({ line: lineNumber, tag, issue: "inconsistent-case", suggestion: lower });
+    }
+  }
+  return { totalFences, issues };
+}
+server.tool(
+  "validate_fence_language_tags",
+  "Scan a Markdown document's fenced code blocks (``` or ~~~) and flag ones with a missing, unknown, or inconsistently-cased language tag, checked against a curated list of common syntax-highlighter language identifiers.",
+  {
+    markdown: z.string().describe("The Markdown document to scan")
+  },
+  async ({ markdown }) => {
+    const result = _validateFenceLanguageTagsMcp(markdown);
+    return text(JSON.stringify(result, null, 2));
+  }
+);
+var _SQL_IDENT_START_MCP = /[A-Za-z_]/;
+var _SQL_IDENT_CHAR_MCP = /[A-Za-z0-9_]/;
+function _readSqlIdentifierMcp(sql, start) {
+  let end = start;
+  while (end < sql.length && _SQL_IDENT_CHAR_MCP.test(sql[end])) end++;
+  return sql.slice(start, end);
+}
+function _countSqlPlaceholdersMcp(sql) {
+  const placeholders = [];
+  let state = "normal";
+  let i = 0;
+  while (i < sql.length) {
+    const ch = sql[i];
+    const next = sql[i + 1];
+    if (state === "single") {
+      if (ch === "'" && next === "'") {
+        i += 2;
+        continue;
+      }
+      if (ch === "'") {
+        state = "normal";
+        i++;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (state === "double") {
+      if (ch === '"' && next === '"') {
+        i += 2;
+        continue;
+      }
+      if (ch === '"') {
+        state = "normal";
+        i++;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (state === "line-comment") {
+      if (ch === "\n") state = "normal";
+      i++;
+      continue;
+    }
+    if (state === "block-comment") {
+      if (ch === "*" && next === "/") {
+        state = "normal";
+        i += 2;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "'") {
+      state = "single";
+      i++;
+      continue;
+    }
+    if (ch === '"') {
+      state = "double";
+      i++;
+      continue;
+    }
+    if (ch === "-" && next === "-") {
+      state = "line-comment";
+      i += 2;
+      continue;
+    }
+    if (ch === "/" && next === "*") {
+      state = "block-comment";
+      i += 2;
+      continue;
+    }
+    if (ch === "?") {
+      placeholders.push({ style: "anonymous", raw: "?", index: i });
+      i++;
+      continue;
+    }
+    if (ch === "$" && /[0-9]/.test(next ?? "")) {
+      let end = i + 1;
+      while (end < sql.length && /[0-9]/.test(sql[end])) end++;
+      const raw = sql.slice(i, end);
+      placeholders.push({ style: "numbered", raw, index: i, number: parseInt(raw.slice(1), 10) });
+      i = end;
+      continue;
+    }
+    if (ch === ":") {
+      if (next === ":") {
+        i += 2;
+        continue;
+      }
+      if (next && _SQL_IDENT_START_MCP.test(next)) {
+        const name = _readSqlIdentifierMcp(sql, i + 1);
+        placeholders.push({ style: "named-colon", raw: `:${name}`, index: i, name });
+        i += 1 + name.length;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    if (ch === "@") {
+      if (next === "@") {
+        i += 2;
+        continue;
+      }
+      if (next && _SQL_IDENT_START_MCP.test(next)) {
+        const name = _readSqlIdentifierMcp(sql, i + 1);
+        placeholders.push({ style: "named-at", raw: `@${name}`, index: i, name });
+        i += 1 + name.length;
+        continue;
+      }
+      i++;
+      continue;
+    }
+    i++;
+  }
+  const counts = { anonymous: 0, numbered: 0, "named-colon": 0, "named-at": 0 };
+  for (const p of placeholders) counts[p.style]++;
+  const stylesUsed = ["anonymous", "numbered", "named-colon", "named-at"].filter((s) => counts[s] > 0);
+  const numbers = placeholders.filter((p) => p.style === "numbered").map((p) => p.number);
+  const maxNumber = numbers.length > 0 ? Math.max(...numbers) : 0;
+  const seen = new Set(numbers);
+  const numberedGaps = [];
+  for (let n = 1; n < maxNumber; n++) {
+    if (!seen.has(n)) numberedGaps.push(n);
+  }
+  const countedMap = /* @__PURE__ */ new Map();
+  for (const n of numbers) countedMap.set(n, (countedMap.get(n) ?? 0) + 1);
+  const numberedDuplicates = [...countedMap.entries()].filter(([, c]) => c > 1).map(([n]) => n).sort((a, b) => a - b);
+  return {
+    placeholders,
+    counts,
+    stylesUsed,
+    mixedStyles: stylesUsed.length > 1,
+    numberedGaps,
+    numberedDuplicates
+  };
+}
+server.tool(
+  "count_sql_placeholders",
+  "Count and list positional (?, $1) and named (:name, @name) parameter placeholders in a SQL query string, flagging a mix of placeholder styles in the same query and, for numbered placeholders, a gap or duplicate in the sequence. String literals and comments are skipped.",
+  {
+    sql: z.string().describe("The SQL query string to scan")
+  },
+  async ({ sql }) => {
+    const result = _countSqlPlaceholdersMcp(sql);
+    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.80.0",
+  "version": "0.82.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",