# paladini/devutils-mcp-server [Health: Active] **Category:** ๐Ÿ’ฐ Finance & Fintech **Repository:** https://github.com/paladini/devutils-mcp-server **GitHub Stars:** 5 **npm Downloads (last month):** 205 **Views:** 1 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/paladini-devutils-mcp-server ## Description 36 zero-auth developer utilities: MD5/SHA/bcrypt hashing, Base64/hex/URL encoding, UUID/password/passphrase generation, JWT decoding, JSON/YAML/XML formatting, timestamp conversion, CIDR calculator, and text tools. ## Tools Capabilities this server exposes over MCP: - **hash_md5** โ€” Generate an MD5 hash of the given input string. - **hash_sha1** โ€” Generate a SHA-1 hash of the given input string. - **hash_sha256** โ€” Generate a SHA-256 hash of the given input string. - **hash_sha512** โ€” Generate a SHA-512 hash of the given input string. - **hash_bcrypt** โ€” Generate a bcrypt hash of the given input string. Useful for password hashing. - **hash_bcrypt_verify** โ€” Verify a string against a bcrypt hash. Returns true if matches. - **base64_encode** โ€” Encode a string to Base64. - **base64_decode** โ€” Decode a Base64 string back to plain text. - **url_encode** โ€” URL-encode a string (percent-encoding). - **url_decode** โ€” Decode a URL-encoded string. - **html_encode** โ€” Encode special characters in a string to HTML entities. - **html_decode** โ€” Decode HTML entities in a string back to their original characters. - **hex_encode** โ€” Encode a string to its hexadecimal representation. - **hex_decode** โ€” Decode a hexadecimal string back to plain text. - **generate_uuid** โ€” Generate a cryptographically secure UUID v4. - **generate_nanoid** โ€” Generate a NanoID โ€” a compact, URL-friendly unique ID. - **generate_password** โ€” Generate a secure random password with configurable options. - **generate_random_hex** โ€” Generate a random hexadecimal string of the specified byte length. - **jwt_decode** โ€” Decode a JWT (JSON Web Token) and display its header and payload without verifying the signature. Useful for debugging and inspecting tokens. - **jwt_validate** โ€” Validate the structure of a JWT. Checks format, Base64URL encoding, JSON validity, and expiration status. Does NOT verify the cryptographic signature. - **json_format** โ€” Format (pretty-print) a JSON string with configurable indentation. Can also minify JSON. - **json_validate** โ€” Validate a JSON string and report any parsing errors with their approximate location. - **json_path_query** โ€” Extract a value from a JSON object using a dot-notation path (e.g., 'user.address.city' or 'items[0].name'). - **timestamp_to_date** โ€” Convert a Unix timestamp (seconds or milliseconds) to a human-readable ISO 8601 date string. - **date_to_timestamp** โ€” Convert a date string to a Unix timestamp. Accepts ISO 8601 and common date formats. - **number_base_convert** โ€” Convert a number between different bases (binary, octal, decimal, hexadecimal, or any base 2-36). - **color_convert** โ€” Convert colors between HEX, RGB, and HSL formats. - **byte_convert** โ€” Convert between byte units (B, KB, MB, GB, TB, PB). Supports both binary (1024) and SI (1000) standards. - **cidr_calculate** โ€” Calculate network details from a CIDR notation (e.g., '192.168.1.0/24'). Returns network address, broadcast, host range, and host count. - **ip_validate** โ€” Validate and classify an IPv4 or IPv6 address. Returns type, class, scope, and whether it's private/loopback/multicast. - **text_stats** โ€” Analyze text and return detailed statistics: character count, word count, line count, sentence count, paragraph count, and reading time. - **lorem_ipsum** โ€” Generate Lorem Ipsum placeholder text. - **case_convert** โ€” Convert a string between different casing styles: camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE, Title Case, and more. - **slugify** โ€” Convert a string to a URL-friendly slug. Removes special characters, replaces spaces with hyphens, and lowercases everything. - **regex_test** โ€” Test a regular expression pattern against an input string. Returns all matches with groups and indices. - **text_diff** โ€” Compare two strings and show a simple line-by-line diff. Lines prefixed with '+' are additions, '-' are deletions, ' ' are unchanged. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "devutils-mcp-server": { "command": "npx", "args": ["-y","devutils-mcp-server"] } } ``` ## Documentation & README

Harness Score L0 (Unharnessed): measures AI-assisted development harness maturity with harness-score

DevUtils MCP Server logo

# DevUtils MCP Server **36 everyday developer tools for any MCP-compatible AI assistant.** Hashing, encoding, UUID generation, JWT decoding, JSON formatting, network tools, text utilities, and more โ€” all local, no external APIs. Think of it as **`busybox` for developer tools** โ€” small, essential, and always useful.

License: MIT MCP npm Docker Glama Smithery MCP Registry GitHub stars

**Also available as a plugin:** [devutils-cursor-plugin](https://github.com/paladini/devutils-cursor-plugin) โ€” one-click install for Cursor and Claude Code.

Add DevUtils to Cursor    Install DevUtils in VS Code

DevUtils MCP Server demo โ€” UUID generation, JWT decode, JSON validation

--- ## Why? Every developer needs to hash strings, encode/decode data, generate UUIDs, decode JWTs, format JSON, calculate CIDR ranges, and convert timestamps **every day**. DevUtils MCP Server brings all of these tools directly into your AI assistant โ€” works with Claude, Cursor, VS Code, Windsurf, and any other MCP-compatible client. --- ## Installation > **Prerequisite:** [Node.js](https://nodejs.org/) 18+ (Node 22 recommended). Verify with `node -v`. ### One-click / plugin Use the **Add to Cursor** / **VS Code** badges above, or install the plugin: ```text /plugin marketplace add paladini/devutils-cursor-plugin /plugin install devutils-mcp@devutils-cursor-plugin ``` Cursor: **Settings โ†’ Customize**, or add from GitHub `paladini/devutils-cursor-plugin`. ### npx (no install) ```bash npx -y devutils-mcp-server ``` ### npm ```bash npm install -g devutils-mcp-server devutils-mcp-server ``` ### Docker ```bash # Published image (when available) docker run -i --rm ghcr.io/paladini/devutils-mcp-server # Or build locally docker build -t devutils-mcp-server . docker run -i --rm devutils-mcp-server # Or with Compose docker compose build docker compose run --rm -i devutils-mcp ``` ### Official MCP Registry Listed as [`io.github.paladini/devutils-mcp-server`](https://registry.modelcontextprotocol.io). Search for `io.github.paladini/devutils`. ### GitHub Packages Releases are dual-published to npm and GitHub Packages as [`@paladini/devutils-mcp-server`](https://github.com/paladini/devutils-mcp-server/pkgs/npm/devutils-mcp-server) (see [`.github/workflows/release.yml`](https://github.com/paladini/devutils-mcp-server/blob/HEAD/.github/workflows/release.yml)). Prefer the public npm package for most installs; use GitHub Packages when you already authenticate against `npm.pkg.github.com`. ```bash # After authenticating to npm.pkg.github.com for the @paladini scope: npx -y @paladini/devutils-mcp-server ``` ### Smithery Also available on [Smithery](https://smithery.ai/server/devutils-mcp-server). --- ## Client setup ### Cursor **One-click:** use the **Add to Cursor** badge at the top of this README. **Plugin (recommended):** Install [DevUtils MCP](https://github.com/paladini/devutils-cursor-plugin) from **Cursor Settings โ†’ Customize**. **Manual:** Add to `~/.cursor/mcp.json`: ```json { "mcpServers": { "devutils": { "command": "npx", "args": ["-y", "devutils-mcp-server"] } } } ``` ### Claude Desktop Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows): ```json { "mcpServers": { "devutils": { "command": "npx", "args": ["-y", "devutils-mcp-server"] } } } ``` Or with Docker: ```json { "mcpServers": { "devutils": { "command": "docker", "args": ["run", "-i", "--rm", "ghcr.io/paladini/devutils-mcp-server"] } } } ``` ### Claude Code ```text /plugin marketplace add paladini/devutils-cursor-plugin /plugin install devutils-mcp@devutils-cursor-plugin ``` ### VS Code (GitHub Copilot) **One-click:** use the VS Code badge at the top, or add to `.vscode/mcp.json` / user settings: ```json { "servers": { "devutils": { "type": "stdio", "command": "npx", "args": ["-y", "devutils-mcp-server"] } } } ``` ### Windsurf Add to `~/.codeium/windsurf/mcp_config.json`: ```json { "mcpServers": { "devutils": { "command": "npx", "args": ["-y", "devutils-mcp-server"] } } } ``` ### Docker MCP Toolkit (Docker Desktop) If this server is available in the [Docker MCP Catalog](https://hub.docker.com/mcp): 1. Open **Docker Desktop โ†’ MCP Toolkit** 2. Search for **DevUtils** 3. Click **Enable** ### Local development ```bash npm install npm run dev ``` --- ## Available tools (36) ### Hash (6) | Tool | Description | |------|-------------| | `hash_md5` | Generate MD5 hash | | `hash_sha1` | Generate SHA-1 hash | | `hash_sha256` | Generate SHA-256 hash | | `hash_sha512` | Generate SHA-512 hash | | `hash_bcrypt` | Generate bcrypt hash (configurable rounds) | | `hash_bcrypt_verify` | Verify string against bcrypt hash | ### Encoding (8) | Tool | Description | |------|-------------| | `base64_encode` | Encode string to Base64 | | `base64_decode` | Decode Base64 to string | | `url_encode` | URL-encode (percent-encoding) | | `url_decode` | Decode URL-encoded string | | `html_encode` | Encode HTML entities | | `html_decode` | Decode HTML entities | | `hex_encode` | Encode string to hex | | `hex_decode` | Decode hex to string | ### Generators (4) | Tool | Description | |------|-------------| | `generate_uuid` | Cryptographic UUID v4 (batch support) | | `generate_nanoid` | Compact URL-friendly ID (configurable length) | | `generate_password` | Secure password (configurable complexity) | | `generate_random_hex` | Random hex string (configurable length) | ### JWT (2) | Tool | Description | |------|-------------| | `jwt_decode` | Decode JWT header & payload (with human-readable dates) | | `jwt_validate` | Validate JWT structure & expiration | ### Formatters (3) | Tool | Description | |------|-------------| | `json_format` | Pretty-print or minify JSON | | `json_validate` | Validate JSON with error location | | `json_path_query` | Extract values using dot-notation path | ### Converters (5) | Tool | Description | |------|-------------| | `timestamp_to_date` | Unix timestamp โ†’ human date (timezone support) | | `date_to_timestamp` | Date string โ†’ Unix timestamp | | `number_base_convert` | Convert between bases (bin/oct/dec/hex/any) | | `color_convert` | Convert colors (HEX โ†” RGB โ†” HSL) | | `byte_convert` | Convert byte units (B/KB/MB/GB/TB/PB) | ### Network (2) | Tool | Description | |------|-------------| | `cidr_calculate` | CIDR โ†’ network, broadcast, mask, host range, host count | | `ip_validate` | Validate & classify IPv4/IPv6 address | ### Text (6) | Tool | Description | |------|-------------| | `text_stats` | Character/word/line/sentence count, reading time | | `lorem_ipsum` | Generate placeholder text | | `case_convert` | Convert between camelCase, snake_case, PascalCase, etc. | | `slugify` | Convert string to URL-friendly slug | | `regex_test` | Test regex pattern against input | | `text_diff` | Line-by-line diff between two texts | --- ## Architecture ``` src/ โ”œโ”€โ”€ index.ts # MCP server entry point (stdio transport) โ””โ”€โ”€ tools/ โ”œโ”€โ”€ hash.ts # Cryptographic hash functions โ”œโ”€โ”€ encoding.ts # Encode/decode utilities โ”œโ”€โ”€ generators.ts # ID and password generators โ”œโ”€โ”€ jwt.ts # JWT decode and validation โ”œโ”€โ”€ formatters.ts # JSON formatting and querying โ”œโ”€โ”€ converters.ts # Data type and unit converters โ”œโ”€โ”€ network.ts # Network calculation utilities โ””โ”€โ”€ text.ts # Text analysis and manipulation ``` **Tech stack:** TypeScript + Node.js 22 ยท [`@modelcontextprotocol/sdk`](https://github.com/modelcontextprotocol/typescript-sdk) ยท `bcryptjs` ยท `nanoid` ยท `zod` **Zero external API dependencies.** All tools run locally with no network calls. --- ## Docker The image uses a multi-stage build for minimal size: 1. **Build stage:** Compiles TypeScript on Node 22 Alpine 2. **Runtime stage:** Runs compiled JS on Node 22 Alpine as a non-root user ```bash docker build -t devutils-mcp-server . # Smoke-test with an MCP initialize request echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0.0"}}}' | docker run -i --rm devutils-mcp-server ``` --- ## FAQ & design philosophy ### Why MCP, and not just a library? **Valid criticism:** If you're writing Python scripts and need to hash something, `hashlib` is 2 lines of code. Why run MCP overhead? **Answer:** This server is optimized for **AI agents** in multi-step workflows, not programmers writing code: 1. **AI hallucination cost >> MCP overhead** โ€” An AI model spending 50ms calling an MCP tool (vs. 1ms library call) is negligible when the alternative is the model *making up a hash* or using the wrong encoding. 2. **Reliable tool semantics** โ€” MCP enforces strict tool contracts. For example, `jwt_decode` *always* returns human-readable dates with timezone support. 3. **Universally accessible** โ€” Any MCP-compatible client can use these tools. A Python library only works if your agent is Python-based. 4. **Multi-tenant safety** โ€” MCP provides explicit tool whitelisting with input validation. ### When to use DevUtils versus alternatives **Use DevUtils if:** - You're using Claude, Cursor, VS Code Copilot, Windsurf, or any MCP-compatible AI assistant - You want reliable, validated utility operations in AI workflows - You need 36 tools in one package **Don't use DevUtils if:** - You're writing regular application code (use native libraries) - You need extreme performance (direct library calls are faster) - Your AI client does not support MCP ### Design philosophy - **Small & focused:** 36 utilities, zero external APIs, ~50MB container - **Security-first:** Non-root user, Alpine Linux, minimal attack surface - **AI-friendly:** Consistent naming (`_`), strict schemas, human-readable outputs - **Client-agnostic:** Works with any MCP-compatible client via stdio transport --- ## Available on | Channel | Link | | --- | --- | | **Official MCP Registry** | `io.github.paladini/devutils-mcp-server` โ€” [registry.modelcontextprotocol.io](https://registry.modelcontextprotocol.io) | | **npm** | [devutils-mcp-server](https://www.npmjs.com/package/devutils-mcp-server) | | **GitHub Packages** | [`@paladini/devutils-mcp-server`](https://github.com/paladini/devutils-mcp-server/pkgs/npm/devutils-mcp-server) (dual-publish on release tags) | | **GHCR (Docker)** | `ghcr.io/paladini/devutils-mcp-server` | | **Glama** | [glama.ai/mcp/servers/paladini/devutils-mcp-server](https://glama.ai/mcp/servers/paladini/devutils-mcp-server) | | **Smithery** | [smithery.ai/server/devutils-mcp-server](https://smithery.ai/server/devutils-mcp-server) | | **Cursor / Claude plugin** | [devutils-cursor-plugin](https://github.com/paladini/devutils-cursor-plugin) | --- ## Contributing Questions and ideas: [GitHub Discussions](https://github.com/paladini/devutils-mcp-server/discussions) Security reports: see [SECURITY.md](https://github.com/paladini/devutils-mcp-server/blob/HEAD/SECURITY.md). 1. Fork the repository 2. Create your feature branch (`git checkout -b feat/amazing-tool`) 3. Commit your changes (`git commit -m 'feat: add amazing tool'`) 4. Push to the branch (`git push origin feat/amazing-tool`) 5. Open a Pull Request See [CHANGELOG.md](https://github.com/paladini/devutils-mcp-server/blob/HEAD/CHANGELOG.md). --- ## License MIT ยฉ [Fernando Paladini](https://github.com/paladini)