mcp-devutils 1.4.0 → 1.5.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 **35 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 (35)
 
 | Tool | Description |
 |------|-------------|
@@ -48,6 +48,11 @@ 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 |
 
 ## 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.5.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -405,6 +405,65 @@ 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"]
+        }
       }
     ]
   };
@@ -1306,6 +1365,90 @@ 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) }]
+        };
+      }
+
       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.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",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -41,7 +41,12 @@
     "ip-address",
     "password-strength",
     "data-size",
-    "string-escape"
+    "string-escape",
+    "nanoid",
+    "csv-json",
+    "hex-encode",
+    "unicode",
+    "byte-count"
   ],
   "author": "Hong Teoh",
   "license": "MIT",