mcp-devutils 1.4.0 → 1.6.0

package/README.md

@@ -1,6 +1,6 @@
 # mcp-devutils
 
-MCP server with **30 developer utilities** for Claude Desktop, Cursor, and any MCP-compatible AI assistant.
+MCP server with **39 developer utilities** for Claude Desktop, Cursor, and any MCP-compatible AI assistant.
 
 ## Install
 
@@ -15,7 +15,7 @@ MCP server with **30 developer utilities** for Claude Desktop, Cursor, and any M
 }
 ```
 
-## Tools (30)
+## Tools (39)
 
 | Tool | Description |
 |------|-------------|
@@ -48,6 +48,16 @@ MCP server with **30 developer utilities** for Claude Desktop, Cursor, and any M
 | `password_strength` | Analyze password entropy and strength |
 | `data_size` | Convert between bytes/KB/MB/GB/TB (SI + IEC) |
 | `string_escape` | Escape strings for JSON/CSV/regex/SQL/shell |
+| `nanoid` | Generate compact, URL-safe unique IDs |
+| `csv_json` | Convert between CSV and JSON |
+| `hex_encode` | Hex encode/decode text |
+| `char_info` | Unicode character info (codepoint, UTF-8 bytes, HTML entity) |
+| `byte_count` | Count string bytes in UTF-8/UTF-16/ASCII |
+| `json_diff` | Compare two JSON objects — show added/removed/changed |
+| `jwt_create` | Create HS256 JWT tokens for API testing |
+| `sql_format` | Format SQL queries with proper indentation |
+| `json_query` | Extract values from JSON using dot-notation paths |
+| `epoch_convert` | Convert epoch timestamps across multiple timezones |
 
 ## Zero dependencies
 

package/index.js

@@ -5,7 +5,7 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprot
 import crypto from "crypto";
 
 const server = new Server(
-  { name: "mcp-devutils", version: "1.4.0" },
+  { name: "mcp-devutils", version: "1.6.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -405,6 +405,125 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           required: ["text", "format"]
         }
+      },
+      {
+        name: "nanoid",
+        description: "Generate compact, URL-safe unique IDs (like UUID but shorter). Customizable length and alphabet.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            length: { type: "number", description: "ID length (default: 21)" },
+            alphabet: { type: "string", description: "Custom alphabet (default: A-Za-z0-9_-)" },
+            count: { type: "number", description: "Number of IDs to generate (default: 1, max: 10)" }
+          }
+        }
+      },
+      {
+        name: "csv_json",
+        description: "Convert between CSV and JSON. CSV→JSON parses CSV text into an array of objects. JSON→CSV converts an array of objects to CSV.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            input: { type: "string", description: "CSV text or JSON string to convert" },
+            direction: { type: "string", enum: ["csv_to_json", "json_to_csv"], description: "Conversion direction" },
+            delimiter: { type: "string", description: "CSV delimiter (default: comma)" }
+          },
+          required: ["input", "direction"]
+        }
+      },
+      {
+        name: "hex_encode",
+        description: "Encode text to hexadecimal or decode hex back to text",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to encode or hex string to decode" },
+            action: { type: "string", enum: ["encode", "decode"], description: "Action (default: encode)" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "char_info",
+        description: "Get Unicode character info — codepoint, name category, UTF-8 bytes, HTML entity for each character in the input",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Characters to analyze (1-20 chars)" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "byte_count",
+        description: "Count the byte length of a string in UTF-8, UTF-16, and ASCII. Useful for checking API payload sizes and database field limits.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Text to measure" }
+          },
+          required: ["text"]
+        }
+      },
+      {
+        name: "json_diff",
+        description: "Compare two JSON objects and show the differences — added, removed, and changed keys. Useful for debugging API responses, config changes, and state diffs.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            a: { type: "string", description: "First JSON string" },
+            b: { type: "string", description: "Second JSON string" }
+          },
+          required: ["a", "b"]
+        }
+      },
+      {
+        name: "jwt_create",
+        description: "Create a JWT token signed with HS256. Useful for testing APIs, mocking auth, and generating test tokens.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            payload: { type: "string", description: "JSON string for the JWT payload (e.g. {\"sub\":\"1234\",\"name\":\"Test\"})" },
+            secret: { type: "string", description: "Secret key for HS256 signing (default: 'secret')" },
+            expiresIn: { type: "number", description: "Expiration in seconds from now (default: 3600)" }
+          },
+          required: ["payload"]
+        }
+      },
+      {
+        name: "sql_format",
+        description: "Format a SQL query with proper indentation and keyword capitalization. Supports SELECT, INSERT, UPDATE, DELETE, CREATE TABLE, and JOIN queries.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            sql: { type: "string", description: "SQL query to format" },
+            uppercase: { type: "boolean", description: "Uppercase SQL keywords (default: true)" }
+          },
+          required: ["sql"]
+        }
+      },
+      {
+        name: "json_query",
+        description: "Extract values from a JSON object using dot-notation paths (e.g. 'user.address.city', 'items[0].name', 'data[*].id'). Useful for quickly inspecting nested API responses.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            json: { type: "string", description: "JSON string to query" },
+            path: { type: "string", description: "Dot-notation path (e.g. 'user.name', 'items[0]', 'data[*].id')" }
+          },
+          required: ["json", "path"]
+        }
+      },
+      {
+        name: "epoch_convert",
+        description: "Convert between epoch milliseconds, seconds, and human-readable dates across multiple timezones. Shows UTC, US Eastern, US Pacific, Europe/London, and Asia/Singapore.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            value: { type: "string", description: "Epoch seconds, epoch milliseconds, or ISO date string. Leave empty for current time." },
+            timezone: { type: "string", description: "Additional IANA timezone to show (e.g. 'Asia/Tokyo')" }
+          }
+        }
       }
     ]
   };
@@ -1306,6 +1425,199 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return { content: [{ type: "text", text: result }] };
       }
 
+      case "nanoid": {
+        const len = Math.min(Math.max(args.length || 21, 1), 128);
+        const alphabet = args.alphabet || "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789_-";
+        const count = Math.min(Math.max(args.count || 1, 1), 10);
+        const ids = [];
+        for (let i = 0; i < count; i++) {
+          const bytes = crypto.randomBytes(len);
+          let id = "";
+          for (let j = 0; j < len; j++) {
+            id += alphabet[bytes[j] % alphabet.length];
+          }
+          ids.push(id);
+        }
+        return { content: [{ type: "text", text: ids.join("\n") }] };
+      }
+
+      case "csv_json": {
+        const { input, direction, delimiter = "," } = args;
+        if (direction === "csv_to_json") {
+          const lines = input.split("\n").filter(l => l.trim());
+          if (lines.length < 1) throw new Error("CSV must have at least a header row");
+          const headers = lines[0].split(delimiter).map(h => h.trim().replace(/^"|"$/g, ""));
+          const rows = lines.slice(1).map(line => {
+            const vals = line.split(delimiter).map(v => v.trim().replace(/^"|"$/g, ""));
+            const obj = {};
+            headers.forEach((h, i) => { obj[h] = vals[i] || ""; });
+            return obj;
+          });
+          return { content: [{ type: "text", text: JSON.stringify(rows, null, 2) }] };
+        } else {
+          const arr = JSON.parse(input);
+          if (!Array.isArray(arr) || arr.length === 0) throw new Error("Input must be a non-empty JSON array");
+          const headers = Object.keys(arr[0]);
+          const csvLines = [headers.join(delimiter)];
+          for (const row of arr) {
+            csvLines.push(headers.map(h => {
+              const val = String(row[h] ?? "");
+              return val.includes(delimiter) || val.includes('"') || val.includes("\n")
+                ? `"${val.replace(/"/g, '""')}"` : val;
+            }).join(delimiter));
+          }
+          return { content: [{ type: "text", text: csvLines.join("\n") }] };
+        }
+      }
+
+      case "hex_encode": {
+        const action = args.action || "encode";
+        if (action === "encode") {
+          return { content: [{ type: "text", text: Buffer.from(args.text, "utf-8").toString("hex") }] };
+        } else {
+          const hex = args.text.replace(/\s/g, "");
+          return { content: [{ type: "text", text: Buffer.from(hex, "hex").toString("utf-8") }] };
+        }
+      }
+
+      case "char_info": {
+        const chars = [...args.text].slice(0, 20);
+        const info = chars.map(ch => {
+          const cp = ch.codePointAt(0);
+          const hex = cp.toString(16).toUpperCase().padStart(4, "0");
+          const utf8Bytes = Buffer.from(ch, "utf-8");
+          const htmlEntity = cp < 128 ? `&#${cp};` : `&#x${hex};`;
+          return `'${ch}'  U+${hex}  decimal: ${cp}  UTF-8: ${[...utf8Bytes].map(b => b.toString(16).padStart(2, "0")).join(" ")}  HTML: ${htmlEntity}`;
+        });
+        return { content: [{ type: "text", text: info.join("\n") }] };
+      }
+
+      case "byte_count": {
+        const text = args.text;
+        const utf8 = Buffer.byteLength(text, "utf-8");
+        const utf16 = Buffer.byteLength(text, "utf-16le");
+        const ascii = text.length; // JS string length
+        const chars = [...text].length; // actual character count (handles surrogate pairs)
+        return {
+          content: [{ type: "text", text: JSON.stringify({
+            characters: chars,
+            js_length: text.length,
+            utf8_bytes: utf8,
+            utf16_bytes: utf16,
+            ascii_bytes: ascii
+          }, null, 2) }]
+        };
+      }
+
+      case "json_diff": {
+        const objA = JSON.parse(args.a);
+        const objB = JSON.parse(args.b);
+        const diffs = [];
+        const diffObj = (a, b, prefix = "") => {
+          const allKeys = new Set([...Object.keys(a || {}), ...Object.keys(b || {})]);
+          for (const key of allKeys) {
+            const path = prefix ? `${prefix}.${key}` : key;
+            if (!(key in (a || {}))) {
+              diffs.push({ path, type: "added", value: b[key] });
+            } else if (!(key in (b || {}))) {
+              diffs.push({ path, type: "removed", value: a[key] });
+            } else if (typeof a[key] === "object" && typeof b[key] === "object" && a[key] !== null && b[key] !== null && !Array.isArray(a[key]) && !Array.isArray(b[key])) {
+              diffObj(a[key], b[key], path);
+            } else if (JSON.stringify(a[key]) !== JSON.stringify(b[key])) {
+              diffs.push({ path, type: "changed", from: a[key], to: b[key] });
+            }
+          }
+        };
+        diffObj(objA, objB);
+        if (diffs.length === 0) {
+          return { content: [{ type: "text", text: "No differences found." }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify(diffs, null, 2) }] };
+      }
+
+      case "jwt_create": {
+        const payload = JSON.parse(args.payload);
+        const secret = args.secret || "secret";
+        const expiresIn = args.expiresIn || 3600;
+        const header = { alg: "HS256", typ: "JWT" };
+        const now = Math.floor(Date.now() / 1000);
+        payload.iat = payload.iat || now;
+        payload.exp = payload.exp || now + expiresIn;
+        const b64url = (obj) => Buffer.from(JSON.stringify(obj)).toString("base64url");
+        const headerB64 = b64url(header);
+        const payloadB64 = b64url(payload);
+        const signature = crypto.createHmac("sha256", secret).update(`${headerB64}.${payloadB64}`).digest("base64url");
+        const token = `${headerB64}.${payloadB64}.${signature}`;
+        return { content: [{ type: "text", text: `Token: ${token}\n\nHeader: ${JSON.stringify(header, null, 2)}\nPayload: ${JSON.stringify(payload, null, 2)}\n\nSigned with: HS256\nExpires: ${new Date(payload.exp * 1000).toISOString()}` }] };
+      }
+
+      case "sql_format": {
+        const { sql, uppercase = true } = args;
+        const keywords = ["SELECT", "FROM", "WHERE", "AND", "OR", "ORDER BY", "GROUP BY", "HAVING", "LIMIT", "OFFSET", "JOIN", "LEFT JOIN", "RIGHT JOIN", "INNER JOIN", "OUTER JOIN", "FULL JOIN", "CROSS JOIN", "ON", "INSERT INTO", "VALUES", "UPDATE", "SET", "DELETE FROM", "CREATE TABLE", "ALTER TABLE", "DROP TABLE", "AS", "IN", "NOT", "NULL", "IS", "BETWEEN", "LIKE", "EXISTS", "UNION", "UNION ALL", "DISTINCT", "CASE", "WHEN", "THEN", "ELSE", "END"];
+        let formatted = sql.replace(/\s+/g, " ").trim();
+        const newlineBefore = ["SELECT", "FROM", "WHERE", "ORDER BY", "GROUP BY", "HAVING", "LIMIT", "JOIN", "LEFT JOIN", "RIGHT JOIN", "INNER JOIN", "OUTER JOIN", "FULL JOIN", "CROSS JOIN", "INSERT INTO", "VALUES", "UPDATE", "SET", "DELETE FROM", "CREATE TABLE", "UNION", "UNION ALL"];
+        for (const kw of newlineBefore) {
+          const regex = new RegExp(`\\b${kw}\\b`, "gi");
+          const replacement = uppercase ? kw : kw.toLowerCase();
+          formatted = formatted.replace(regex, `\n${replacement}`);
+        }
+        const indentAfter = ["AND", "OR"];
+        for (const kw of indentAfter) {
+          const regex = new RegExp(`\\b${kw}\\b`, "gi");
+          const replacement = uppercase ? kw : kw.toLowerCase();
+          formatted = formatted.replace(regex, `\n  ${replacement}`);
+        }
+        if (uppercase) {
+          for (const kw of ["ON", "AS", "IN", "NOT", "NULL", "IS", "BETWEEN", "LIKE", "EXISTS", "DISTINCT", "CASE", "WHEN", "THEN", "ELSE", "END"]) {
+            const regex = new RegExp(`\\b${kw}\\b`, "gi");
+            formatted = formatted.replace(regex, kw);
+          }
+        }
+        formatted = formatted.trim();
+        return { content: [{ type: "text", text: formatted }] };
+      }
+
+      case "json_query": {
+        const obj = JSON.parse(args.json);
+        const { path } = args;
+        const parts = path.replace(/\[(\d+)\]/g, ".$1").replace(/\[\*\]/g, ".*").split(".");
+        const resolve = (current, parts) => {
+          if (parts.length === 0) return current;
+          const [head, ...rest] = parts;
+          if (head === "*" && Array.isArray(current)) {
+            return current.map(item => resolve(item, rest));
+          }
+          if (current === null || current === undefined) return undefined;
+          const next = Array.isArray(current) ? current[parseInt(head)] : current[head];
+          return resolve(next, rest);
+        };
+        const result = resolve(obj, parts);
+        return { content: [{ type: "text", text: result === undefined ? "undefined (path not found)" : JSON.stringify(result, null, 2) }] };
+      }
+
+      case "epoch_convert": {
+        const { value, timezone } = args || {};
+        const zones = ["UTC", "America/New_York", "America/Los_Angeles", "Europe/London", "Asia/Singapore"];
+        if (timezone && !zones.includes(timezone)) zones.push(timezone);
+        let date;
+        if (!value) {
+          date = new Date();
+        } else if (/^\d+$/.test(value.trim())) {
+          const num = parseInt(value.trim());
+          date = new Date(num > 1e12 ? num : num * 1000);
+        } else {
+          date = new Date(value);
+        }
+        if (isNaN(date.getTime())) throw new Error(`Invalid date/time: ${value}`);
+        const lines = [`Epoch seconds: ${Math.floor(date.getTime() / 1000)}`, `Epoch milliseconds: ${date.getTime()}`, `ISO 8601: ${date.toISOString()}`, ""];
+        for (const tz of zones) {
+          try {
+            lines.push(`${tz}: ${date.toLocaleString("en-US", { timeZone: tz, dateStyle: "full", timeStyle: "long" })}`);
+          } catch { lines.push(`${tz}: (unsupported timezone)`); }
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+      }
+
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-devutils",
-  "version": "1.4.0",
-  "description": "MCP server with 30 developer utilities - UUID, hash, HMAC, base64, timestamps, JWT decode, random strings, URL encode/decode, JSON format, regex test, cron explain, color convert, semver compare, HTTP status codes, slugify, HTML escape, chmod calculator, text diff, number base converter, lorem ipsum, word count, CIDR calculator, case converter, markdown TOC, env parser, IP info, password strength, data size converter, string escape",
+  "version": "1.6.0",
+  "description": "MCP server with 39 developer utilities - UUID, nanoid, hash, HMAC, base64, hex encode, timestamps, JWT decode/create, random strings, URL encode/decode, JSON format/diff/query, CSV/JSON convert, regex test, cron explain, color convert, semver compare, HTTP status codes, slugify, HTML escape, chmod calculator, text diff, number base converter, lorem ipsum, word count, byte count, CIDR calculator, case converter, markdown TOC, env parser, IP info, password strength, data size converter, string escape, char info, SQL format, epoch convert",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -41,7 +41,18 @@
     "ip-address",
     "password-strength",
     "data-size",
-    "string-escape"
+    "string-escape",
+    "nanoid",
+    "csv-json",
+    "hex-encode",
+    "unicode",
+    "byte-count",
+    "json-diff",
+    "jwt-create",
+    "sql-format",
+    "json-query",
+    "epoch-convert",
+    "timezone"
   ],
   "author": "Hong Teoh",
   "license": "MIT",