@utilix-tech/mcp 0.32.0 → 0.33.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.33.0
+- Add `analyze_sentence_lengths` tool: histogram of sentence lengths in words, plus mean, median, standard deviation, and a coefficient-of-variation consistency label, distinct from readability grade scores.
+- Add `format_few_shot_examples` tool: format input/output example pairs into a numbered, XML-tagged, or delimiter-separated few-shot prompt template.
+
 ## 0.32.0
 - Add `calculate_emi` tool: equated monthly installment, total interest, and a year-by-year principal/interest breakdown from principal, annual rate, and tenure in years or months.
 - Add `parse_markdown_front_matter` tool: split a Markdown document into its YAML front matter fields and body content, parsing scalars, inline arrays, and block lists.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 150 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 152 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.
 
@@ -128,7 +128,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `generate_qr` | Generate a QR code as an SVG string |
 | `generate_random_data` | Generate random mock data: names, emails, UUIDs, IPs, etc. |
 
-### Text (13 tools)
+### Text (14 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_case` | Convert text case: camelCase, snake_case, PascalCase, etc. |
@@ -144,6 +144,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `score_readability` | Score text with Flesch Reading Ease, Flesch-Kincaid Grade Level, and Gunning Fog Index |
 | `detect_filler_words` | Scan text for filler words, hedge phrases, and clichés with per-phrase counts and a density score |
 | `calculate_string_distance` | Compute the Levenshtein (or Damerau) edit distance and normalized similarity between two strings |
+| `analyze_sentence_lengths` | Split text into sentences and report a histogram of sentence lengths, plus mean, median, standard deviation, and a consistency label |
 
 ### Time (6 tools)
 | Tool | Description |
@@ -242,7 +243,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `unicode_inspect` | Inspect Unicode code points of a string |
 | `optimize_svg` | Optimize and minify an SVG string |
 
-### AI / Agent (26 tools)
+### AI / Agent (27 tools)
 | Tool | Description |
 |------|-------------|
 | `estimate_tokens` | Estimate token count and cost for an LLM prompt |
@@ -271,6 +272,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `compress_json` | Compress JSON for LLM context budgets |
 | `diff_json_detailed` | Diff two parsed JSON values, returning every path with its op and unchanged paths |
 | `vector_similarity` | Cosine similarity, dot product, and Euclidean / Manhattan distance between two numeric vectors |
+| `format_few_shot_examples` | Format input/output example pairs into a numbered, XML-tagged, or delimiter-separated few-shot prompt template |
 
 ### Image (3 tools)
 | Tool | Description |

package/dist/index.js

@@ -1092,6 +1092,30 @@ server.tool("chunk_text", "Split text into overlapping chunks for RAG.", { text:
 server.tool("extract_urls", "Extract all URLs from text or HTML.", { text: z.string() }, async ({ text: text2 }) => {
   return { content: [{ type: "text", text: JSON.stringify(extractUrls(text2), null, 2) }] };
 });
+function _formatFewShotExamples(examples, format, delimiter) {
+  const valid = (examples ?? []).filter((e) => e?.input?.trim() && e?.output?.trim());
+  if (valid.length === 0) return { formatted: "", exampleCount: 0, format };
+  let formatted;
+  if (format === "xml") {
+    formatted = valid.map((e) => `<example>
+  <input>${e.input.trim()}</input>
+  <output>${e.output.trim()}</output>
+</example>`).join("\n\n");
+  } else if (format === "delimiter") {
+    formatted = valid.map((e) => `Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join(`
+${delimiter}
+`);
+  } else {
+    formatted = valid.map((e, i) => `Example ${i + 1}:
+Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join("\n\n");
+  }
+  return { formatted, exampleCount: valid.length, format };
+}
+server.tool("format_few_shot_examples", "Format a list of input/output example pairs into a standard few-shot prompt template: numbered, XML-tagged, or delimiter-separated.", { examples: z.array(z.object({ input: z.string(), output: z.string() })), format: z.enum(["numbered", "xml", "delimiter"]).default("numbered"), delimiter: z.string().default("---") }, async ({ examples, format, delimiter }) => {
+  return { content: [{ type: "text", text: JSON.stringify(_formatFewShotExamples(examples, format, delimiter), null, 2) }] };
+});
 server.tool("sanitize_html", "Strip HTML tags, scripts, and event handlers for LLM ingestion.", { html: z.string(), keep_links: z.boolean().default(false) }, async ({ html, keep_links }) => {
   return { content: [{ type: "text", text: JSON.stringify(sanitizeHtml(html, keep_links), null, 2) }] };
 });
@@ -3138,6 +3162,74 @@ function _scoreReadability(input) {
 server.tool("score_readability", "Score text with Flesch Reading Ease, Flesch-Kincaid Grade Level, and Gunning Fog Index, using a heuristic syllable counter.", { text: z.string() }, async ({ text: input }) => {
   return { content: [{ type: "text", text: JSON.stringify(_scoreReadability(input), null, 2) }] };
 });
+function _splitIntoSentencesForLengthDist(text2) {
+  const matches = text2.match(/[^.!?]+[.!?]*/g);
+  if (!matches) return [];
+  return matches.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function _countWordsInSentenceForLengthDist(sentence) {
+  return (sentence.match(/[a-zA-Z']+/g) ?? []).length;
+}
+function _analyzeSentenceLengths(input) {
+  const sentences = _splitIntoSentencesForLengthDist(input);
+  const lengths = sentences.map(_countWordsInSentenceForLengthDist).filter((n) => n > 0);
+  if (lengths.length === 0) {
+    return {
+      sentenceCount: 0,
+      lengths: [],
+      minLength: 0,
+      maxLength: 0,
+      meanLength: 0,
+      medianLength: 0,
+      stdDev: 0,
+      coefficientOfVariation: 0,
+      consistency: "No sentences to analyze",
+      buckets: []
+    };
+  }
+  const sentenceCount = lengths.length;
+  const minLength = Math.min(...lengths);
+  const maxLength = Math.max(...lengths);
+  const meanLength = lengths.reduce((a, b) => a + b, 0) / sentenceCount;
+  const sorted = [...lengths].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  const medianLength = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+  const variance = lengths.reduce((sum, n) => sum + (n - meanLength) ** 2, 0) / sentenceCount;
+  const stdDev = Math.sqrt(variance);
+  const coefficientOfVariation = meanLength > 0 ? stdDev / meanLength : 0;
+  let consistency;
+  if (coefficientOfVariation < 0.3) consistency = "Consistent \u2014 sentence lengths vary little";
+  else if (coefficientOfVariation < 0.6) consistency = "Moderate variation in sentence length";
+  else consistency = "Highly variable sentence length";
+  const bucketWidth = 5;
+  const bucketCount = Math.max(1, Math.ceil(maxLength / bucketWidth));
+  const buckets = [];
+  for (let i = 0; i < bucketCount; i++) {
+    const min = i * bucketWidth + 1;
+    const max = (i + 1) * bucketWidth;
+    buckets.push({ label: `${min}-${max}`, min, max, count: 0 });
+  }
+  for (const len of lengths) {
+    const idx = Math.min(Math.floor((len - 1) / bucketWidth), bucketCount - 1);
+    buckets[idx].count++;
+  }
+  const round2 = (n) => Math.round(n * 100) / 100;
+  return {
+    sentenceCount,
+    lengths,
+    minLength,
+    maxLength,
+    meanLength: round2(meanLength),
+    medianLength: round2(medianLength),
+    stdDev: round2(stdDev),
+    coefficientOfVariation: round2(coefficientOfVariation),
+    consistency,
+    buckets
+  };
+}
+server.tool("analyze_sentence_lengths", "Split text into sentences and report a histogram of sentence lengths in words, plus mean, median, standard deviation, and a consistency label. Distinct from readability grade scores.", { text: z.string() }, async ({ text: input }) => {
+  return { content: [{ type: "text", text: JSON.stringify(_analyzeSentenceLengths(input), null, 2) }] };
+});
 var _ID3V1_GENRES = [
   "Blues",
   "Classic Rock",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@utilix-tech/mcp",
-  "version": "0.32.0",
-  "description": "MCP server exposing 143 Utilix developer tools to Claude, Cursor, VS Code Copilot, and any MCP-compatible AI assistant.",
+  "version": "0.33.0",
+  "description": "MCP server exposing 152 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",