mcp-devutils 1.5.0 → 1.6.0

package/README.md

@@ -1,6 +1,6 @@
 # mcp-devutils
 
-MCP server with **35 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 **35 developer utilities** for Claude Desktop, Cursor, and any M
 }
 ```
 
-## Tools (35)
+## Tools (39)
 
 | Tool | Description |
 |------|-------------|
@@ -53,6 +53,11 @@ MCP server with **35 developer utilities** for Claude Desktop, Cursor, and any M
 | `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.5.0" },
+  { name: "mcp-devutils", version: "1.6.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -464,6 +464,66 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           },
           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')" }
+          }
+        }
       }
     ]
   };
@@ -1449,6 +1509,115 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      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.5.0",
-  "description": "MCP server with 35 developer utilities - UUID, nanoid, hash, HMAC, base64, hex encode, timestamps, JWT decode, random strings, URL encode/decode, JSON format, 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",
+  "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": {
@@ -46,7 +46,13 @@
     "csv-json",
     "hex-encode",
     "unicode",
-    "byte-count"
+    "byte-count",
+    "json-diff",
+    "jwt-create",
+    "sql-format",
+    "json-query",
+    "epoch-convert",
+    "timezone"
   ],
   "author": "Hong Teoh",
   "license": "MIT",