@utilix-tech/mcp 0.6.0 → 0.8.0

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 101 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 104 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.
 
@@ -121,7 +121,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 (10 tools)
+### Text (11 tools)
 | Tool | Description |
 |------|-------------|
 | `convert_case` | Convert text case: camelCase, snake_case, PascalCase, etc. |
@@ -134,6 +134,7 @@ claude mcp add utilix -- npx -y @utilix-tech/mcp
 | `html_to_markdown` | Convert HTML to Markdown |
 | `line_operations` | Sort, deduplicate, reverse, shuffle, trim, or number lines |
 | `detect_passive_voice` | Flag sentences written in passive voice, e.g. "was written", "were approved by the team" |
+| `score_readability` | Score text with Flesch Reading Ease, Flesch-Kincaid Grade Level, and Gunning Fog Index |
 
 ### Time (5 tools)
 | Tool | Description |
@@ -230,16 +231,22 @@ 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 |
 
-### Image (1 tool)
+### Image (2 tools)
 | Tool | Description |
 |------|-------------|
 | `read_image_info` | Read format, dimensions, bit depth, and alpha channel from image bytes: no decoding required. Supports PNG, JPEG, GIF, WebP, BMP |
+| `read_exif_data` | Read camera make/model, orientation, timestamps, exposure settings, and GPS coordinates from a JPEG's EXIF data |
 
 ### PDF (1 tool)
 | Tool | Description |
 |------|-------------|
 | `read_pdf_metadata` | Read title, author, dates, page count, and encryption flag from a PDF's trailer/Info dictionary: no PDF rendering library required |
 
+### Audio (1 tool)
+| Tool | Description |
+|------|-------------|
+| `read_wav_info` | Read sample rate, channel count, bit depth, and duration from a WAV file's RIFF/fmt/data chunk headers: no audio library required |
+
 ## Requirements
 
 - Node.js 18+

package/dist/index.js

@@ -1641,6 +1641,196 @@ server.tool("read_pdf_metadata", "Read PDF metadata (title, author, dates, page
   if ("error" in result) return errText(result);
   return text(JSON.stringify(result, null, 2));
 });
+var _EXIF_ORIENTATION_LABELS = {
+  1: "Normal",
+  2: "Mirrored horizontal",
+  3: "Rotated 180\xB0",
+  4: "Mirrored vertical",
+  5: "Mirrored horizontal, rotated 90\xB0 CCW",
+  6: "Rotated 90\xB0 CW",
+  7: "Mirrored horizontal, rotated 90\xB0 CW",
+  8: "Rotated 90\xB0 CCW"
+};
+function _tu16(r, o) {
+  return r.view.getUint16(o, r.little);
+}
+function _tu32(r, o) {
+  return r.view.getUint32(o, r.little);
+}
+function _readIfdEntries(r, ifdOffset) {
+  if (ifdOffset < 0 || ifdOffset + 2 > r.bytes.length) return null;
+  const numEntries = _tu16(r, ifdOffset);
+  const entries = [];
+  for (let i = 0; i < numEntries; i++) {
+    const entryOffset = ifdOffset + 2 + i * 12;
+    if (entryOffset + 12 > r.bytes.length) break;
+    entries.push({ tag: _tu16(r, entryOffset), type: _tu16(r, entryOffset + 2), count: _tu32(r, entryOffset + 4), valueOffsetField: entryOffset + 8 });
+  }
+  return { entries };
+}
+function _findExifEntry(entries, tag) {
+  return entries.find((e) => e.tag === tag);
+}
+function _readExifAscii(r, entry) {
+  const size = entry.count;
+  const inline = size <= 4;
+  const dataOffset = inline ? entry.valueOffsetField : r.tiffStart + _tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + size > r.bytes.length) return null;
+  let out = "";
+  for (let i = 0; i < size; i++) {
+    const c = r.bytes[dataOffset + i];
+    if (c === 0) break;
+    out += String.fromCharCode(c);
+  }
+  const trimmed = out.trim();
+  return trimmed || null;
+}
+function _readExifRational(r, entry) {
+  const dataOffset = r.tiffStart + _tu32(r, entry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 8 > r.bytes.length) return null;
+  return { num: _tu32(r, dataOffset), den: _tu32(r, dataOffset + 4) };
+}
+function _readExifGpsCoordinate(r, entries, valueTag, refTag) {
+  const valueEntry = _findExifEntry(entries, valueTag);
+  if (!valueEntry) return null;
+  const dataOffset = r.tiffStart + _tu32(r, valueEntry.valueOffsetField);
+  if (dataOffset < 0 || dataOffset + 24 > r.bytes.length) return null;
+  const deg = _tu32(r, dataOffset) / (_tu32(r, dataOffset + 4) || 1);
+  const min = _tu32(r, dataOffset + 8) / (_tu32(r, dataOffset + 12) || 1);
+  const sec = _tu32(r, dataOffset + 16) / (_tu32(r, dataOffset + 20) || 1);
+  let decimal = deg + min / 60 + sec / 3600;
+  const refEntry = _findExifEntry(entries, refTag);
+  const ref = refEntry ? _readExifAscii(r, refEntry) : null;
+  if (ref === "S" || ref === "W") decimal = -decimal;
+  return Math.round(decimal * 1e6) / 1e6;
+}
+function _gcdExif(a, b) {
+  return b === 0 ? a : _gcdExif(b, a % b);
+}
+function _round2Exif(n) {
+  return Math.round(n * 100) / 100;
+}
+function _formatExposureTime(num, den) {
+  if (num === 0) return "0s";
+  if (num >= den) return `${_round2Exif(num / den)}s`;
+  const divisor = _gcdExif(num, den) || 1;
+  const n = num / divisor;
+  const d = den / divisor;
+  return `1/${Math.round(d / n)}`;
+}
+function _readExifData(bytes) {
+  if (bytes.length < 4 || bytes[0] !== 255 || bytes[1] !== 216) {
+    return { error: "Not a JPEG file (EXIF is only read from JPEG files)" };
+  }
+  let offset = 2;
+  let exifStart = -1;
+  while (offset + 4 <= bytes.length) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    if (marker === 217 || marker === 218) break;
+    const segmentLength = bytes[offset + 2] << 8 | bytes[offset + 3];
+    if (marker === 225) {
+      const idOffset = offset + 4;
+      if (idOffset + 6 <= bytes.length && bytes[idOffset] === 69 && bytes[idOffset + 1] === 120 && bytes[idOffset + 2] === 105 && bytes[idOffset + 3] === 102 && bytes[idOffset + 4] === 0 && bytes[idOffset + 5] === 0) {
+        exifStart = idOffset + 6;
+        break;
+      }
+    }
+    offset += 2 + segmentLength;
+  }
+  if (exifStart === -1) return { error: "No EXIF segment found in this JPEG" };
+  if (exifStart + 8 > bytes.length) return { error: "Truncated EXIF segment" };
+  const byteOrder = String.fromCharCode(bytes[exifStart], bytes[exifStart + 1]);
+  if (byteOrder !== "II" && byteOrder !== "MM") return { error: "Invalid TIFF byte order marker in EXIF data" };
+  const little = byteOrder === "II";
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const r = { bytes, view, little, tiffStart: exifStart };
+  if (_tu16(r, exifStart + 2) !== 42) return { error: "Invalid TIFF magic number in EXIF data" };
+  const ifd0Offset = exifStart + _tu32(r, exifStart + 4);
+  const ifd0 = _readIfdEntries(r, ifd0Offset);
+  if (!ifd0) return { error: "Could not read IFD0 from EXIF data" };
+  const result = { tagCount: ifd0.entries.length };
+  const makeEntry = _findExifEntry(ifd0.entries, 271);
+  if (makeEntry) {
+    const v = _readExifAscii(r, makeEntry);
+    if (v) result.make = v;
+  }
+  const modelEntry = _findExifEntry(ifd0.entries, 272);
+  if (modelEntry) {
+    const v = _readExifAscii(r, modelEntry);
+    if (v) result.model = v;
+  }
+  const softwareEntry = _findExifEntry(ifd0.entries, 305);
+  if (softwareEntry) {
+    const v = _readExifAscii(r, softwareEntry);
+    if (v) result.software = v;
+  }
+  const dateTimeEntry = _findExifEntry(ifd0.entries, 306);
+  if (dateTimeEntry) {
+    const v = _readExifAscii(r, dateTimeEntry);
+    if (v) result.dateTime = v;
+  }
+  const orientEntry = _findExifEntry(ifd0.entries, 274);
+  if (orientEntry) {
+    const v = _tu16(r, orientEntry.valueOffsetField);
+    result.orientation = v;
+    result.orientationLabel = _EXIF_ORIENTATION_LABELS[v] ?? "Unknown";
+  }
+  const exifIfdPtr = _findExifEntry(ifd0.entries, 34665);
+  if (exifIfdPtr) {
+    const subOffset = exifStart + _tu32(r, exifIfdPtr.valueOffsetField);
+    const sub = _readIfdEntries(r, subOffset);
+    if (sub) {
+      const dtoEntry = _findExifEntry(sub.entries, 36867);
+      if (dtoEntry) {
+        const v = _readExifAscii(r, dtoEntry);
+        if (v) result.dateTimeOriginal = v;
+      }
+      const expEntry = _findExifEntry(sub.entries, 33434);
+      if (expEntry) {
+        const rat = _readExifRational(r, expEntry);
+        if (rat && rat.den !== 0) result.exposureTime = _formatExposureTime(rat.num, rat.den);
+      }
+      const fEntry = _findExifEntry(sub.entries, 33437);
+      if (fEntry) {
+        const rat = _readExifRational(r, fEntry);
+        if (rat && rat.den !== 0) result.fNumber = _round2Exif(rat.num / rat.den);
+      }
+      const isoEntry = _findExifEntry(sub.entries, 34855);
+      if (isoEntry) result.isoSpeed = _tu16(r, isoEntry.valueOffsetField);
+      const focalEntry = _findExifEntry(sub.entries, 37386);
+      if (focalEntry) {
+        const rat = _readExifRational(r, focalEntry);
+        if (rat && rat.den !== 0) result.focalLength = _round2Exif(rat.num / rat.den);
+      }
+    }
+  }
+  const gpsIfdPtr = _findExifEntry(ifd0.entries, 34853);
+  if (gpsIfdPtr) {
+    const gpsOffset = exifStart + _tu32(r, gpsIfdPtr.valueOffsetField);
+    const gps = _readIfdEntries(r, gpsOffset);
+    if (gps) {
+      const lat = _readExifGpsCoordinate(r, gps.entries, 2, 1);
+      const lon = _readExifGpsCoordinate(r, gps.entries, 4, 3);
+      if (lat !== null) result.gpsLatitude = lat;
+      if (lon !== null) result.gpsLongitude = lon;
+    }
+  }
+  return result;
+}
+server.tool("read_exif_data", "Read common EXIF tags (camera make/model, orientation, timestamps, exposure settings, GPS coordinates) directly from a JPEG's APP1 segment. Only JPEG is supported.", { image_base64: z.string().describe("Base64-encoded JPEG bytes, optionally prefixed with a data: URL scheme") }, async ({ image_base64 }) => {
+  const bytes = new Uint8Array(Buffer.from(image_base64.replace(/^data:.*;base64,/, ""), "base64"));
+  const result = _readExifData(bytes);
+  if ("error" in result) return errText(result);
+  return text(JSON.stringify(result, null, 2));
+});
 function _parseJwks(input) {
   const trimmed = input.trim();
   if (!trimmed) return { error: "No input provided" };
@@ -1686,5 +1876,136 @@ server.tool("parse_jwks", "Parse a JSON Web Key Set (or a single bare JWK) and s
   if ("error" in result) return errText(result);
   return text(JSON.stringify(result, null, 2));
 });
+var _WAV_AUDIO_FORMAT_LABELS = { 1: "PCM", 3: "IEEE float", 6: "A-law", 7: "mu-law", 65534: "Extensible" };
+function _readWavAscii4(bytes, offset) {
+  return String.fromCharCode(bytes[offset], bytes[offset + 1], bytes[offset + 2], bytes[offset + 3]);
+}
+function _readWavInfo(bytes) {
+  if (bytes.length < 12) return { error: "File is too small to be a valid WAV file" };
+  if (_readWavAscii4(bytes, 0) !== "RIFF") return { error: 'Not a RIFF file (missing "RIFF" header)' };
+  if (_readWavAscii4(bytes, 8) !== "WAVE") return { error: 'Not a WAVE file (missing "WAVE" format marker)' };
+  const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+  const fileSize = view.getUint32(4, true) + 8;
+  let offset = 12;
+  let fmt = null;
+  let dataSize = null;
+  while (offset + 8 <= bytes.length) {
+    const chunkId = _readWavAscii4(bytes, offset);
+    const chunkSize = view.getUint32(offset + 4, true);
+    const dataOffset = offset + 8;
+    if (chunkId === "fmt ") {
+      if (dataOffset + 16 > bytes.length) return { error: 'Truncated "fmt " chunk' };
+      fmt = {
+        audioFormat: view.getUint16(dataOffset, true),
+        channels: view.getUint16(dataOffset + 2, true),
+        sampleRate: view.getUint32(dataOffset + 4, true),
+        byteRate: view.getUint32(dataOffset + 8, true),
+        blockAlign: view.getUint16(dataOffset + 12, true),
+        bitsPerSample: view.getUint16(dataOffset + 14, true)
+      };
+    } else if (chunkId === "data") {
+      dataSize = Math.min(chunkSize, bytes.length - dataOffset);
+    }
+    offset = dataOffset + chunkSize + chunkSize % 2;
+    if (fmt && dataSize !== null) break;
+  }
+  if (!fmt) return { error: 'No "fmt " chunk found in this WAV file' };
+  if (dataSize === null) return { error: 'No "data" chunk found in this WAV file' };
+  if (fmt.byteRate <= 0) return { error: 'Invalid byte rate in "fmt " chunk' };
+  const durationSeconds = Math.round(dataSize / fmt.byteRate * 1e3) / 1e3;
+  return {
+    audioFormat: fmt.audioFormat,
+    audioFormatLabel: _WAV_AUDIO_FORMAT_LABELS[fmt.audioFormat] ?? `Unknown (0x${fmt.audioFormat.toString(16)})`,
+    channels: fmt.channels,
+    sampleRate: fmt.sampleRate,
+    byteRate: fmt.byteRate,
+    blockAlign: fmt.blockAlign,
+    bitsPerSample: fmt.bitsPerSample,
+    dataSize,
+    durationSeconds,
+    fileSize
+  };
+}
+server.tool("read_wav_info", "Read sample rate, channel count, bit depth, and duration directly from a WAV file's RIFF/fmt/data chunk headers. No audio library required.", { wav_base64: z.string().describe("Base64-encoded WAV file bytes, optionally prefixed with a data: URL scheme") }, async ({ wav_base64 }) => {
+  const bytes = new Uint8Array(Buffer.from(wav_base64.replace(/^data:.*;base64,/, ""), "base64"));
+  const result = _readWavInfo(bytes);
+  if ("error" in result) return errText(result);
+  return text(JSON.stringify(result, null, 2));
+});
+function _readabilitySplitIntoSentences(text2) {
+  const matches = text2.match(/[^.!?]+[.!?]*/g);
+  if (!matches) return [];
+  return matches.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function _countReadabilitySyllables(word) {
+  const w = word.toLowerCase().replace(/[^a-z]/g, "");
+  if (w.length === 0) return 0;
+  if (w.length <= 3) return 1;
+  let count = 0;
+  let prevWasVowel = false;
+  for (const ch of w) {
+    const isVowel = "aeiouy".includes(ch);
+    if (isVowel && !prevWasVowel) count++;
+    prevWasVowel = isVowel;
+  }
+  if (w.endsWith("e") && !w.endsWith("le") && count > 1) count--;
+  if (w.endsWith("le") && w.length > 2 && !"aeiouy".includes(w[w.length - 3])) count++;
+  return Math.max(count, 1);
+}
+function _readabilityGradeLabel(fleschReadingEase) {
+  if (fleschReadingEase >= 90) return "Very easy (5th grade)";
+  if (fleschReadingEase >= 80) return "Easy (6th grade)";
+  if (fleschReadingEase >= 70) return "Fairly easy (7th grade)";
+  if (fleschReadingEase >= 60) return "Standard (8th-9th grade)";
+  if (fleschReadingEase >= 50) return "Fairly difficult (10th-12th grade)";
+  if (fleschReadingEase >= 30) return "Difficult (college)";
+  return "Very difficult (college graduate)";
+}
+function _round1Readability(n) {
+  return Math.round(n * 10) / 10;
+}
+function _scoreReadability(input) {
+  const sentences = _readabilitySplitIntoSentences(input);
+  const words = input.match(/[a-zA-Z']+/g) ?? [];
+  const sentenceCount = Math.max(sentences.length, 1);
+  const wordCount = words.length;
+  const syllableCounts = words.map(_countReadabilitySyllables);
+  const syllableCount = syllableCounts.reduce((a, b) => a + b, 0);
+  const complexWordCount = syllableCounts.filter((c) => c >= 3).length;
+  if (wordCount === 0) {
+    return {
+      wordCount: 0,
+      sentenceCount: 0,
+      syllableCount: 0,
+      complexWordCount: 0,
+      avgWordsPerSentence: 0,
+      avgSyllablesPerWord: 0,
+      fleschReadingEase: 0,
+      fleschKincaidGrade: 0,
+      gunningFog: 0,
+      readingLevel: "No text to score"
+    };
+  }
+  const avgWordsPerSentence = wordCount / sentenceCount;
+  const avgSyllablesPerWord = syllableCount / wordCount;
+  const fleschReadingEase = _round1Readability(206.835 - 1.015 * avgWordsPerSentence - 84.6 * avgSyllablesPerWord);
+  const fleschKincaidGrade = _round1Readability(0.39 * avgWordsPerSentence + 11.8 * avgSyllablesPerWord - 15.59);
+  const gunningFog = _round1Readability(0.4 * (avgWordsPerSentence + 100 * (complexWordCount / wordCount)));
+  return {
+    wordCount,
+    sentenceCount: sentences.length,
+    syllableCount,
+    complexWordCount,
+    avgWordsPerSentence: _round1Readability(avgWordsPerSentence),
+    avgSyllablesPerWord: _round1Readability(avgSyllablesPerWord),
+    fleschReadingEase,
+    fleschKincaidGrade,
+    gunningFog,
+    readingLevel: _readabilityGradeLabel(fleschReadingEase)
+  };
+}
+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) }] };
+});
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

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