@utilix-tech/mcp 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/mcp
 
-MCP server exposing 99 developer utility tools to Claude, Cursor, VS Code Copilot, and any [Model Context Protocol](https://modelcontextprotocol.io) compatible AI assistant.
+MCP server exposing 102 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.
 
@@ -150,10 +150,11 @@ 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 (5 tools)
+### API / Network (6 tools)
 | Tool | Description |
 |------|-------------|
 | `decode_jwt` | Decode a JWT: header, payload, and expiry |
+| `parse_jwks` | Parse a JWKS (or a single bare JWK): type, use, algorithm, key ID, and size per key |
 | `build_curl` | Build a cURL command from method, URL, headers, and body |
 | `curl_to_code` | Convert a cURL command to fetch, axios, Python, Go, PHP, or Ruby |
 | `cors_headers` | Generate CORS response headers for a configuration |
@@ -229,10 +230,16 @@ 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 |
 
 ## Requirements
 

package/dist/index.js

@@ -1496,5 +1496,385 @@ server.tool(
     return text(formatted);
   }
 );
+function _decodePdfString(raw, isHex) {
+  const bytes = [];
+  if (isHex) {
+    const hex = raw.replace(/\s+/g, "");
+    const padded = hex.length % 2 === 0 ? hex : hex + "0";
+    for (let i = 0; i < padded.length; i += 2) bytes.push(parseInt(padded.slice(i, i + 2), 16));
+  } else {
+    const s = raw.replace(/\\\r\n|\\\r|\\\n/g, "");
+    for (let i = 0; i < s.length; i++) {
+      const ch = s[i];
+      if (ch === "\\" && i + 1 < s.length) {
+        const next = s[i + 1];
+        if (next === "n") {
+          bytes.push(10);
+          i++;
+        } else if (next === "r") {
+          bytes.push(13);
+          i++;
+        } else if (next === "t") {
+          bytes.push(9);
+          i++;
+        } else if (next === "b") {
+          bytes.push(8);
+          i++;
+        } else if (next === "f") {
+          bytes.push(12);
+          i++;
+        } else if (next === "(" || next === ")" || next === "\\") {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        } else if (/[0-7]/.test(next)) {
+          let oct = next;
+          i++;
+          for (let k = 0; k < 2 && i + 1 < s.length && /[0-7]/.test(s[i + 1]); k++) {
+            i++;
+            oct += s[i];
+          }
+          bytes.push(parseInt(oct, 8) & 255);
+        } else {
+          bytes.push(next.charCodeAt(0));
+          i++;
+        }
+      } else {
+        bytes.push(ch.charCodeAt(0) & 255);
+      }
+    }
+  }
+  if (bytes.length >= 2 && bytes[0] === 254 && bytes[1] === 255) {
+    let out = "";
+    for (let i = 2; i + 1 < bytes.length; i += 2) out += String.fromCharCode(bytes[i] << 8 | bytes[i + 1]);
+    return out;
+  }
+  return bytes.map((b) => String.fromCharCode(b)).join("");
+}
+function _extractPdfField(dict, key) {
+  const litMatch = dict.match(new RegExp(`/${key}\\s*\\(((?:\\\\.|[^\\\\()])*)\\)`));
+  if (litMatch) return _decodePdfString(litMatch[1], false);
+  const hexMatch = dict.match(new RegExp(`/${key}\\s*<([0-9A-Fa-f\\s]*)>`));
+  if (hexMatch) return _decodePdfString(hexMatch[1], true);
+  return null;
+}
+function _findPdfObject(text2, objNum, gen) {
+  const m = text2.match(new RegExp(`(?:^|[^0-9])${objNum}\\s+${gen}\\s+obj([\\s\\S]*?)endobj`));
+  return m ? m[1] : null;
+}
+function _parsePdfDate(raw) {
+  const m = raw.match(/^D:(\d{4})(\d{2})?(\d{2})?(\d{2})?(\d{2})?(\d{2})?([Z+-])?(\d{2})?'?(\d{2})?'?/);
+  if (!m) return null;
+  const [, y, mo = "01", d = "01", h = "00", mi = "00", s = "00", tz, tzh, tzm] = m;
+  let iso = `${y}-${mo}-${d}T${h}:${mi}:${s}`;
+  if (tz === "Z") iso += "Z";
+  else if (tz === "+" || tz === "-") iso += `${tz}${tzh ?? "00"}:${tzm ?? "00"}`;
+  return iso;
+}
+function _readPdfMetadata(bytes) {
+  if (bytes.length < 8) return { error: "File too small to be a PDF" };
+  const latin1 = (b) => {
+    let out = "";
+    for (let i = 0; i < b.length; i += 32768) out += String.fromCharCode(...b.subarray(i, i + 32768));
+    return out;
+  };
+  const header = latin1(bytes.subarray(0, 16));
+  const versionMatch = header.match(/%PDF-(\d\.\d)/);
+  if (!versionMatch) return { error: "Not a valid PDF file (missing %PDF header)" };
+  const version = versionMatch[1];
+  const text2 = latin1(bytes);
+  const trailerMatches = [...text2.matchAll(/trailer\s*<<([\s\S]*?)>>/g)];
+  let infoDict = null;
+  let encrypted = false;
+  if (trailerMatches.length > 0) {
+    const trailer = trailerMatches[trailerMatches.length - 1][1];
+    encrypted = /\/Encrypt\s+\d+\s+\d+\s+R/.test(trailer);
+    const infoRef = trailer.match(/\/Info\s+(\d+)\s+(\d+)\s+R/);
+    if (infoRef) infoDict = _findPdfObject(text2, Number(infoRef[1]), Number(infoRef[2]));
+  }
+  const objBlocks = [...text2.matchAll(/(\d+)\s+(\d+)\s+obj([\s\S]*?)endobj/g)];
+  if (!infoDict) {
+    for (const b of objBlocks) {
+      if (/\/(Title|Author|Producer|Creator|CreationDate)\b/.test(b[3]) && !/\/Type\s*\/(Page|Pages|Catalog|Font)\b/.test(b[3])) {
+        infoDict = b[3];
+        break;
+      }
+    }
+  }
+  const title = infoDict ? _extractPdfField(infoDict, "Title") : null;
+  const author = infoDict ? _extractPdfField(infoDict, "Author") : null;
+  const subject = infoDict ? _extractPdfField(infoDict, "Subject") : null;
+  const keywords = infoDict ? _extractPdfField(infoDict, "Keywords") : null;
+  const creator = infoDict ? _extractPdfField(infoDict, "Creator") : null;
+  const producer = infoDict ? _extractPdfField(infoDict, "Producer") : null;
+  const creationDateRaw = infoDict ? _extractPdfField(infoDict, "CreationDate") : null;
+  const modDateRaw = infoDict ? _extractPdfField(infoDict, "ModDate") : null;
+  let pageCount = null;
+  for (const b of objBlocks) {
+    if (!/\/Type\s*\/Pages\b/.test(b[3])) continue;
+    const countMatch = b[3].match(/\/Count\s+(\d+)/);
+    if (countMatch) {
+      const c = Number(countMatch[1]);
+      if (pageCount === null || c > pageCount) pageCount = c;
+    }
+  }
+  if (pageCount === null) {
+    const pageMatches = text2.match(/\/Type\s*\/Page(?!s)\b/g);
+    if (pageMatches) pageCount = pageMatches.length;
+  }
+  return {
+    version,
+    pageCount,
+    title,
+    author,
+    subject,
+    keywords,
+    creator,
+    producer,
+    creationDate: creationDateRaw ? _parsePdfDate(creationDateRaw) ?? creationDateRaw : null,
+    modDate: modDateRaw ? _parsePdfDate(modDateRaw) ?? modDateRaw : null,
+    encrypted
+  };
+}
+server.tool("read_pdf_metadata", "Read PDF metadata (title, author, dates, page count, encryption flag) directly from the trailer/Info dictionary: no PDF rendering library required.", { pdf_base64: z.string().describe("Base64-encoded PDF bytes, optionally prefixed with a data: URL scheme") }, async ({ pdf_base64 }) => {
+  const bytes = new Uint8Array(Buffer.from(pdf_base64.replace(/^data:.*;base64,/, ""), "base64"));
+  const result = _readPdfMetadata(bytes);
+  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" };
+  let data;
+  try {
+    data = JSON.parse(trimmed);
+  } catch (e) {
+    return { error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  let rawKeys;
+  if (data && typeof data === "object" && Array.isArray(data.keys)) {
+    rawKeys = data.keys;
+  } else if (data && typeof data === "object" && typeof data.kty === "string") {
+    rawKeys = [data];
+  } else {
+    return { error: 'Input must be a JWKS object with a "keys" array, or a single JWK object with a "kty" field' };
+  }
+  const base64urlByteLength = (s) => Math.floor(s.replace(/=+$/, "").length * 6 / 8);
+  const keys = rawKeys.map((k) => {
+    const key = k ?? {};
+    const kty = typeof key.kty === "string" ? key.kty : "unknown";
+    let keySize = null;
+    let curve;
+    if (kty === "RSA" && typeof key.n === "string") keySize = base64urlByteLength(key.n) * 8;
+    else if ((kty === "EC" || kty === "OKP") && typeof key.crv === "string") curve = key.crv;
+    else if (kty === "oct" && typeof key.k === "string") keySize = base64urlByteLength(key.k) * 8;
+    return {
+      kty,
+      use: typeof key.use === "string" ? key.use : void 0,
+      alg: typeof key.alg === "string" ? key.alg : void 0,
+      kid: typeof key.kid === "string" ? key.kid : void 0,
+      keySize,
+      curve
+    };
+  });
+  const kidCounts = /* @__PURE__ */ new Map();
+  for (const k of keys) if (k.kid) kidCounts.set(k.kid, (kidCounts.get(k.kid) ?? 0) + 1);
+  const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
+  return { keys, count: keys.length, duplicateKids };
+}
+server.tool("parse_jwks", "Parse a JSON Web Key Set (or a single bare JWK) and summarize each key's type, use, algorithm, key ID, and approximate size. Does not verify or use the keys cryptographically.", { input: z.string().describe('JWKS JSON (a "keys" array) or a single JWK object') }, async ({ input }) => {
+  const result = _parseJwks(input);
+  if ("error" in result) return errText(result);
+  return text(JSON.stringify(result, null, 2));
+});
 var transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

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