mcp-devutils 1.6.0 → 2.0.0

package/README.md

@@ -1,6 +1,8 @@
 # mcp-devutils
 
-MCP server with **39 developer utilities** for Claude Desktop, Cursor, and any MCP-compatible AI assistant.
+MCP server with **44 developer utilities** for Claude Desktop, Cursor, and any MCP-compatible AI assistant.
+
+**15 tools free** — unlock all 44 with a Pro license key.
 
 ## Install
 
@@ -15,7 +17,27 @@ MCP server with **39 developer utilities** for Claude Desktop, Cursor, and any M
 }
 ```
 
-## Tools (39)
+## Unlock Pro (29 extra tools)
+
+1. Support development at [buymeacoffee.com/gl89tu25lp](https://buymeacoffee.com/gl89tu25lp)
+2. Get your license key in the confirmation
+3. Add it to your MCP config:
+
+```json
+{
+  "mcpServers": {
+    "devutils": {
+      "command": "npx",
+      "args": ["-y", "mcp-devutils"],
+      "env": {
+        "MCP_DEVUTILS_KEY": "your-key-here"
+      }
+    }
+  }
+}
+```
+
+## Free Tools (15)
 
 | Tool | Description |
 |------|-------------|
@@ -31,10 +53,15 @@ MCP server with **39 developer utilities** for Claude Desktop, Cursor, and any M
 | `cron_explain` | Explain cron expressions + next run times |
 | `hmac` | Generate HMAC signatures |
 | `color_convert` | Convert hex ↔ RGB ↔ HSL colors |
-| `semver_compare` | Compare semantic versions |
 | `http_status` | Look up HTTP status code meanings |
 | `slug` | Generate URL-safe slugs |
 | `escape_html` | Escape/unescape HTML entities |
+
+## Pro Tools (29)
+
+| Tool | Description |
+|------|-------------|
+| `semver_compare` | Compare semantic versions |
 | `chmod_calc` | Convert numeric ↔ symbolic permissions |
 | `diff` | Compare two text strings |
 | `number_base` | Convert decimal/hex/octal/binary |
@@ -58,6 +85,11 @@ MCP server with **39 developer utilities** for Claude Desktop, Cursor, and any M
 | `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 |
+| `aes_encrypt` | AES-256-CBC encrypt text with any key |
+| `aes_decrypt` | Decrypt AES-256-CBC encrypted text |
+| `rsa_keygen` | Generate RSA key pairs (1024/2048/4096-bit) |
+| `scrypt_hash` | Hash passwords with scrypt (RFC 7914) |
+| `regex_replace` | Find & replace with regex + capture groups |
 
 ## Zero dependencies
 
@@ -65,9 +97,7 @@ Only requires `@modelcontextprotocol/sdk`. All tools use Node.js built-ins.
 
 ## Support
 
-If this tool saves you time, consider supporting development:
-
-- [Buy me a coffee](https://buymeacoffee.com/gl89tu25lp)
+- [Buy me a coffee](https://buymeacoffee.com/gl89tu25lp) — unlocks Pro tools!
 - [Tip via Stripe ($3)](https://buy.stripe.com/dRm8wP8R295Z9VyeN59Zm00)
 
 ## License

package/index.js

@@ -4,14 +4,33 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import crypto from "crypto";
 
+// --- Freemium gating ---
+const PRO_KEY = process.env.MCP_DEVUTILS_KEY || "";
+const isProUnlocked = PRO_KEY.length >= 16;
+
+const FREE_TOOLS = new Set([
+  "uuid", "hash", "base64", "timestamp", "jwt_decode",
+  "random_string", "url_encode", "json_format", "regex_test",
+  "cron_explain", "hmac", "color_convert", "http_status",
+  "slug", "escape_html"
+]);
+
+const UPGRADE_MSG = `🔒 This is a PRO tool. Upgrade to unlock 29 additional developer tools!
+
+Get your license key: https://buymeacoffee.com/gl89tu25lp
+
+After purchase, set your key:
+  export MCP_DEVUTILS_KEY="your-key-here"
+
+Then restart your MCP client. All 44 tools will be unlocked.`;
+
 const server = new Server(
-  { name: "mcp-devutils", version: "1.6.0" },
+  { name: "mcp-devutils", version: "2.0.0" },
   { capabilities: { tools: {} } }
 );
 
 server.setRequestHandler(ListToolsRequestSchema, async () => {
-  return {
-    tools: [
+  const allTools = [
       {
         name: "uuid",
         description: "Generate a UUID v4",
@@ -524,14 +543,90 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             timezone: { type: "string", description: "Additional IANA timezone to show (e.g. 'Asia/Tokyo')" }
           }
         }
+      },
+      {
+        name: "aes_encrypt",
+        description: "Encrypt text using AES-256-CBC. Returns hex-encoded IV + ciphertext. Use a strong key (will be hashed to 256 bits internally).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Plaintext to encrypt" },
+            key: { type: "string", description: "Encryption key (any string — will be SHA-256 hashed to derive 256-bit key)" }
+          },
+          required: ["text", "key"]
+        }
+      },
+      {
+        name: "aes_decrypt",
+        description: "Decrypt AES-256-CBC encrypted text. Expects hex-encoded input from aes_encrypt.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            encrypted: { type: "string", description: "Hex-encoded string (IV + ciphertext) from aes_encrypt" },
+            key: { type: "string", description: "Same key used for encryption" }
+          },
+          required: ["encrypted", "key"]
+        }
+      },
+      {
+        name: "rsa_keygen",
+        description: "Generate an RSA key pair (PEM format). Useful for testing, dev environments, and learning.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            bits: { type: "number", description: "Key size in bits: 1024, 2048, or 4096 (default: 2048)" }
+          }
+        }
+      },
+      {
+        name: "scrypt_hash",
+        description: "Hash a password using Node.js scrypt (RFC 7914). Returns hex-encoded salt + hash for secure password storage.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            password: { type: "string", description: "Password to hash" },
+            salt: { type: "string", description: "Optional salt (hex). If omitted, a random 16-byte salt is generated." }
+          },
+          required: ["password"]
+        }
+      },
+      {
+        name: "regex_replace",
+        description: "Find and replace text using a regular expression. Supports capture groups ($1, $2, etc.) in the replacement string.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            text: { type: "string", description: "Input text" },
+            pattern: { type: "string", description: "Regular expression pattern" },
+            replacement: { type: "string", description: "Replacement string (use $1, $2 for capture groups)" },
+            flags: { type: "string", description: "Regex flags (default: 'g'). Common: 'gi' for global case-insensitive." }
+          },
+          required: ["text", "pattern", "replacement"]
+        }
       }
-    ]
-  };
+  ];
+
+  // Label pro tools when not unlocked
+  const tools = allTools.map(tool => {
+    if (!FREE_TOOLS.has(tool.name) && !isProUnlocked) {
+      return { ...tool, description: `[PRO] ${tool.description}` };
+    }
+    return tool;
+  });
+
+  return { tools };
 });
 
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
 
+  // Gate pro tools
+  if (!FREE_TOOLS.has(name) && !isProUnlocked) {
+    return {
+      content: [{ type: "text", text: UPGRADE_MSG }]
+    };
+  }
+
   try {
     switch (name) {
       case "uuid": {
@@ -1618,6 +1713,54 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return { content: [{ type: "text", text: lines.join("\n") }] };
       }
 
+      case "aes_encrypt": {
+        const keyHash = crypto.createHash("sha256").update(args.key).digest();
+        const iv = crypto.randomBytes(16);
+        const cipher = crypto.createCipheriv("aes-256-cbc", keyHash, iv);
+        let encrypted = cipher.update(args.text, "utf8", "hex");
+        encrypted += cipher.final("hex");
+        const result = iv.toString("hex") + encrypted;
+        return { content: [{ type: "text", text: `Encrypted (hex): ${result}\n\nIV (first 32 hex chars): ${iv.toString("hex")}\nCiphertext: ${encrypted}\nTotal length: ${result.length} hex chars` }] };
+      }
+
+      case "aes_decrypt": {
+        const keyHash = crypto.createHash("sha256").update(args.key).digest();
+        const encHex = args.encrypted;
+        if (encHex.length < 34) throw new Error("Encrypted string too short — must contain 32-char IV + ciphertext");
+        const iv = Buffer.from(encHex.slice(0, 32), "hex");
+        const ciphertext = encHex.slice(32);
+        const decipher = crypto.createDecipheriv("aes-256-cbc", keyHash, iv);
+        let decrypted = decipher.update(ciphertext, "hex", "utf8");
+        decrypted += decipher.final("utf8");
+        return { content: [{ type: "text", text: decrypted }] };
+      }
+
+      case "rsa_keygen": {
+        const bits = [1024, 2048, 4096].includes(args?.bits) ? args.bits : 2048;
+        const { publicKey, privateKey } = crypto.generateKeyPairSync("rsa", {
+          modulusLength: bits,
+          publicKeyEncoding: { type: "spki", format: "pem" },
+          privateKeyEncoding: { type: "pkcs8", format: "pem" }
+        });
+        return { content: [{ type: "text", text: `=== RSA ${bits}-bit Key Pair ===\n\n--- Public Key ---\n${publicKey}\n--- Private Key ---\n${privateKey}\n⚠️ This is for dev/testing. Never share private keys.` }] };
+      }
+
+      case "scrypt_hash": {
+        const salt = args.salt ? Buffer.from(args.salt, "hex") : crypto.randomBytes(16);
+        const derived = crypto.scryptSync(args.password, salt, 64);
+        const saltHex = salt.toString("hex");
+        const hashHex = derived.toString("hex");
+        return { content: [{ type: "text", text: `Salt (hex): ${saltHex}\nHash (hex): ${hashHex}\nCombined: ${saltHex}:${hashHex}\n\nTo verify, use the same salt with scrypt_hash.` }] };
+      }
+
+      case "regex_replace": {
+        const flags = args.flags || "g";
+        const regex = new RegExp(args.pattern, flags);
+        const result = args.text.replace(regex, args.replacement);
+        const matchCount = (args.text.match(regex) || []).length;
+        return { content: [{ type: "text", text: `Matches found: ${matchCount}\n\n--- Result ---\n${result}` }] };
+      }
+
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-devutils",
-  "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",
+  "version": "2.0.0",
+  "description": "MCP server with 44 developer utilities (15 free + 29 pro). Free: UUID, hash, HMAC, base64, timestamps, JWT decode, random strings, URL encode/decode, JSON format, regex test, cron explain, color convert, HTTP status, slugify, HTML escape. Pro: nanoid, hex encode, JWT create, JSON diff/query, CSV/JSON convert, regex replace, semver compare, chmod calc, text diff, number base, lorem ipsum, word/byte count, CIDR calc, case convert, markdown TOC, env parser, IP info, password strength, data size, string escape, char info, SQL format, epoch convert, AES encrypt/decrypt, RSA keygen, scrypt hash",
   "type": "module",
   "main": "index.js",
   "bin": {
@@ -52,7 +52,14 @@
     "sql-format",
     "json-query",
     "epoch-convert",
-    "timezone"
+    "timezone",
+    "aes",
+    "encryption",
+    "rsa",
+    "keygen",
+    "scrypt",
+    "password-hash",
+    "regex-replace"
   ],
   "author": "Hong Teoh",
   "license": "MIT",