devutils-mcp-server

Un servidor MCP DevUtils de código abierto — un completo kit de herramientas de utilidades para desarrolladores para el Catálogo MCP de Docker. Proporciona 36 herramientas en 8 categorías que los asistentes de IA pueden invocar directamente.

Documentación

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

DevUtils MCP Server logo

Servidor MCP DevUtils

36 herramientas de desarrollo cotidianas para cualquier asistente de IA compatible con MCP. Hashing, codificación, generación de UUID, decodificación de JWT, formato JSON, herramientas de red, utilidades de texto y más — todo local, sin APIs externas.

Piénsalo como busybox para herramientas de desarrollo — pequeño, esencial y siempre útil.

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

También disponible como plugin: devutils-cursor-plugin — instalación con un clic para Cursor y Claude Code.

Add DevUtils to Cursor    Install DevUtils in VS Code

DevUtils MCP Server demo — UUID generation, JWT decode, JSON validation


¿Por qué?

Todo desarrollador necesita generar hashes de cadenas, codificar/decodificar datos, generar UUIDs, decodificar JWTs, formatear JSON, calcular rangos CIDR y convertir marcas de tiempo todos los días. DevUtils MCP Server lleva todas estas herramientas directamente a tu asistente de IA — funciona con Claude, Cursor, VS Code, Windsurf y cualquier otro cliente compatible con MCP.


Instalación

Requisito previo: Node.js 18+ (se recomienda Node 22). Verifica con node -v.

Un clic / plugin

Usa las insignias Agregar a Cursor / VS Code de arriba, o instala el plugin:

/plugin marketplace add paladini/devutils-cursor-plugin
/plugin install devutils-mcp@devutils-cursor-plugin

Cursor: Configuración → Personalizar, o agrégalo desde GitHub paladini/devutils-cursor-plugin.

npx (sin instalación)

npx -y devutils-mcp-server

npm

npm install -g devutils-mcp-server
devutils-mcp-server

Docker

# 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

Registro Oficial de MCP

Listado como io.github.paladini/devutils-mcp-server. Busca io.github.paladini/devutils.

GitHub Packages

Los lanzamientos se publican de forma dual en npm y GitHub Packages como @paladini/devutils-mcp-server (consulta .github/workflows/release.yml). Prefiere el paquete público de npm para la mayoría de las instalaciones; usa GitHub Packages cuando ya te autentiques contra npm.pkg.github.com.

# After authenticating to npm.pkg.github.com for the @paladini scope:
npx -y @paladini/devutils-mcp-server

Smithery

También disponible en Smithery.


Configuración del cliente

Cursor

Un clic: usa la insignia Agregar a Cursor al inicio de este README.

Plugin (recomendado): Instala DevUtils MCP desde Configuración de Cursor → Personalizar.

Manual: Agrega a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "devutils": {
      "command": "npx",
      "args": ["-y", "devutils-mcp-server"]
    }
  }
}

Claude Desktop

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "devutils": {
      "command": "npx",
      "args": ["-y", "devutils-mcp-server"]
    }
  }
}

O con Docker:

{
  "mcpServers": {
    "devutils": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/paladini/devutils-mcp-server"]
    }
  }
}

Claude Code

/plugin marketplace add paladini/devutils-cursor-plugin
/plugin install devutils-mcp@devutils-cursor-plugin

VS Code (GitHub Copilot)

Un clic: usa la insignia de VS Code al inicio, o agrega a .vscode/mcp.json / configuración de usuario:

{
  "servers": {
    "devutils": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "devutils-mcp-server"]
    }
  }
}

Windsurf

Agrega a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "devutils": {
      "command": "npx",
      "args": ["-y", "devutils-mcp-server"]
    }
  }
}

Docker MCP Toolkit (Docker Desktop)

Si este servidor está disponible en el Catálogo MCP de Docker:

  1. Abre Docker Desktop → MCP Toolkit
  2. Busca DevUtils
  3. Haz clic en Habilitar

Desarrollo local

npm install
npm run dev

Herramientas disponibles (36)

Hash (6)

HerramientaDescripción
hash_md5Genera hash MD5
hash_sha1Genera hash SHA-1
hash_sha256Genera hash SHA-256
hash_sha512Genera hash SHA-512
hash_bcryptGenera hash bcrypt (rondas configurables)
hash_bcrypt_verifyVerifica una cadena contra un hash bcrypt

Codificación (8)

HerramientaDescripción
base64_encodeCodifica una cadena a Base64
base64_decodeDecodifica Base64 a cadena
url_encodeCodifica URL (codificación porcentual)
url_decodeDecodifica una cadena codificada en URL
html_encodeCodifica entidades HTML
html_decodeDecodifica entidades HTML
hex_encodeCodifica una cadena a hexadecimal
hex_decodeDecodifica hexadecimal a cadena

Generadores (4)

HerramientaDescripción
generate_uuidUUID v4 criptográfico (soporte por lotes)
generate_nanoidID compacto y amigable para URL (longitud configurable)
generate_passwordContraseña segura (complejidad configurable)
generate_random_hexCadena hexadecimal aleatoria (longitud configurable)

JWT (2)

HerramientaDescripción
jwt_decodeDecodifica encabezado y carga útil de JWT (con fechas legibles)
jwt_validateValida estructura y expiración de JWT

Formateadores (3)

HerramientaDescripción
json_formatImprime o minimiza JSON de forma legible
json_validateValida JSON con ubicación de error
json_path_queryExtrae valores usando ruta de notación de puntos

Convertidores (5)

HerramientaDescripción
timestamp_to_dateMarca de tiempo Unix → fecha legible (soporte de zona horaria)
date_to_timestampCadena de fecha → marca de tiempo Unix
number_base_convertConvierte entre bases (bin/oct/dec/hex/cualquiera)
color_convertConvierte colores (HEX ↔ RGB ↔ HSL)
byte_convertConvierte unidades de bytes (B/KB/MB/GB/TB/PB)

Red (2)

HerramientaDescripción
cidr_calculateCIDR → red, broadcast, máscara, rango de hosts, cantidad de hosts
ip_validateValida y clasifica direcciones IPv4/IPv6

Texto (6)

HerramientaDescripción
text_statsConteo de caracteres/palabras/líneas/oraciones, tiempo de lectura
lorem_ipsumGenera texto de relleno
case_convertConvierte entre camelCase, snake_case, PascalCase, etc.
slugifyConvierte una cadena a slug amigable para URL
regex_testPrueba un patrón regex contra una entrada
text_diffDiferencia línea por línea entre dos textos

Arquitectura

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

Stack tecnológico: TypeScript + Node.js 22 · @modelcontextprotocol/sdk · bcryptjs · nanoid · zod

Cero dependencias de APIs externas. Todas las herramientas se ejecutan localmente sin llamadas de red.


Docker

La imagen usa una compilación de múltiples etapas para un tamaño mínimo:

  1. Etapa de compilación: Compila TypeScript en Node 22 Alpine
  2. Etapa de ejecución: Ejecuta JS compilado en Node 22 Alpine como usuario no root
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

Preguntas frecuentes y filosofía de diseño

¿Por qué MCP y no solo una biblioteca?

Crítica válida: Si estás escribiendo scripts en Python y necesitas generar un hash, hashlib son 2 líneas de código. ¿Por qué ejecutar la sobrecarga de MCP?

Respuesta: Este servidor está optimizado para agentes de IA en flujos de trabajo de múltiples pasos, no para programadores que escriben código:

  1. El costo de la alucinación de IA >> sobrecarga de MCP — Un modelo de IA que tarda 50 ms en llamar a una herramienta MCP (vs. 1 ms de una llamada de biblioteca) es insignificante cuando la alternativa es que el modelo invente un hash o use la codificación incorrecta.
  2. Semántica confiable de herramientas — MCP impone contratos estrictos de herramientas. Por ejemplo, jwt_decode siempre devuelve fechas legibles con soporte de zona horaria.
  3. Accesible universalmente — Cualquier cliente compatible con MCP puede usar estas herramientas. Una biblioteca de Python solo funciona si tu agente está basado en Python.
  4. Seguridad multiinquilino — MCP proporciona listas blancas explícitas de herramientas con validación de entrada.

Cuándo usar DevUtils versus alternativas

Usa DevUtils si:

  • Estás usando Claude, Cursor, VS Code Copilot, Windsurf o cualquier asistente de IA compatible con MCP
  • Quieres operaciones de utilidad confiables y validadas en flujos de trabajo de IA
  • Necesitas 36 herramientas en un solo paquete

No uses DevUtils si:

  • Estás escribiendo código de aplicación regular (usa bibliotecas nativas)
  • Necesitas rendimiento extremo (las llamadas directas a bibliotecas son más rápidas)
  • Tu cliente de IA no admite MCP

Filosofía de diseño

  • Pequeño y enfocado: 36 utilidades, cero APIs externas, contenedor de ~50 MB
  • Seguridad primero: Usuario no root, Alpine Linux, superficie de ataque mínima
  • Amigable con IA: Nombres consistentes (<domain>_<operation>), esquemas estrictos, salidas legibles
  • Independiente del cliente: Funciona con cualquier cliente compatible con MCP mediante transporte stdio

Disponible en

CanalEnlace
Registro Oficial de MCPio.github.paladini/devutils-mcp-server — registry.modelcontextprotocol.io
npmdevutils-mcp-server
GitHub Packages@paladini/devutils-mcp-server (publicación dual en etiquetas de lanzamiento)
GHCR (Docker)ghcr.io/paladini/devutils-mcp-server
Glamaglama.ai/mcp/servers/paladini/devutils-mcp-server
Smitherysmithery.ai/server/devutils-mcp-server
Plugin Cursor / Claudedevutils-cursor-plugin

Contribuciones

Preguntas e ideas: Discusiones de GitHub

Informes de seguridad: consulta SECURITY.md.

  1. Haz un fork del repositorio
  2. Crea tu rama de características (git checkout -b feat/amazing-tool)
  3. Haz commit de tus cambios (git commit -m 'feat: add amazing tool')
  4. Haz push a la rama (git push origin feat/amazing-tool)
  5. Abre una Solicitud de Extracción (Pull Request)

Consulta CHANGELOG.md.


Licencia

MIT © Fernando Paladini