DevUtils MCP Server

DevUtils MCP 服务

适用于任何兼容 MCP 的 AI 助手的 36 款日常开发工具。 哈希计算、编码、UUID 生成、JWT 解码、JSON 格式化、网络工具、文本实用工具等——全部在本地运行，无需外部 API。

可以把它看作开发工具界的 busybox——小巧、实用，而且随时派得上用场。

另有插件版本： devutils-cursor-plugin — 一键安装到 Cursor 和 Claude Code。

  

---

为什么选择它？

每位开发者每天都需要对字符串进行哈希计算、编码/解码数据、生成 UUID、解码 JWT、格式化 JSON、计算 CIDR 网段以及转换时间戳。DevUtils MCP 服务将这些工具直接集成到你的 AI 助手中——兼容 Claude、Cursor、VS Code、Windsurf 以及任何其他兼容 MCP 的客户端。

---

安装

前提条件： Node.js 18+（推荐 Node 22）。运行 node -v 验证。

一键安装 / 插件

使用上方的 Add to Cursor / VS Code 徽标，或安装插件：

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

Cursor：进入 Settings → Customize，或从 GitHub 添加 paladini/devutils-cursor-plugin。

npx（无需安装）

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

官方 MCP 注册表

已收录为 io.github.paladini/devutils-mcp-server。搜索 io.github.paladini/devutils。

GitHub Packages

发布版本会同时发布到 npm 和 GitHub Packages，包名为 @paladini/devutils-mcp-server（参见 .github/workflows/release.yml）。大多数情况下，建议使用公开的 npm 包进行安装；如果你已通过 npm.pkg.github.com 完成身份验证，则可使用 GitHub Packages。

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

Smithery

也可在 Smithery 上使用。

---

客户端配置

Cursor

一键配置： 使用本 README 顶部的 Add to Cursor 徽章。

插件（推荐）： 在 Cursor Settings → Customize 中安装 DevUtils MCP。

手动配置： 添加到 ~/.cursor/mcp.json：

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

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

或者使用 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）

一键配置： 使用顶部的 VS Code 徽章，或添加到 .vscode/mcp.json / 用户设置中：

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

Windsurf

添加到 ~/.codeium/windsurf/mcp_config.json：

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

Docker MCP Toolkit（Docker Desktop）

如果此服务已收录在 Docker MCP Catalog 中：

1. 打开 Docker Desktop → MCP Toolkit
2. 搜索 DevUtils
3. 点击 Enable

本地开发

npm install
npm run dev

---

可用工具（36）

哈希（6）

工具	描述
hash_md5	生成 MD5 哈希
hash_sha1	生成 SHA-1 哈希
hash_sha256	生成 SHA-256 哈希
hash_sha512	生成 SHA-512 哈希
hash_bcrypt	生成 bcrypt 哈希（可配置轮数）
hash_bcrypt_verify	验证字符串是否与 bcrypt 哈希匹配

编码（8）

工具	描述
base64_encode	将字符串编码为 Base64
base64_decode	将 Base64 解码为字符串
url_encode	对 URL 进行编码（百分号编码）
url_decode	解码经过 URL 编码的字符串
html_encode	编码 HTML 实体
html_decode	解码 HTML 实体
hex_encode	将字符串编码为十六进制
hex_decode	将十六进制解码为字符串

生成器（4）

工具	描述
generate_uuid	生成加密安全的 UUID v4（支持批量生成）
generate_nanoid	生成简洁、适用于 URL 的 ID（可配置长度）
generate_password	生成安全密码（可配置复杂度）
generate_random_hex	生成随机十六进制字符串（可配置长度）

JWT（2）

工具	描述
jwt_decode	解码 JWT 标头和负载（包含人类可读的日期）
jwt_validate	验证 JWT 结构和有效期

格式化工具（3）

工具	描述
json_format	美化或压缩 JSON
json_validate	验证 JSON 并指出错误位置
json_path_query	使用点表示法路径提取值

转换器（5）

工具	描述
timestamp_to_date	将 Unix 时间戳转换为可读日期（支持时区）
date_to_timestamp	将日期字符串转换为 Unix 时间戳
number_base_convert	在不同进制间转换（bin/oct/dec/hex/任意进制）
color_convert	转换颜色（HEX ↔ RGB ↔ HSL）
byte_convert	转换字节单位（B/KB/MB/GB/TB/PB）

网络（2）

工具	描述
cidr_calculate	将 CIDR 转换为网络地址、广播地址、掩码、主机范围和主机数量
ip_validate	验证并分类 IPv4/IPv6 地址

文本（6）

工具	描述
text_stats	字符数、单词数、行数、句子数及阅读时间
lorem_ipsum	生成占位文本
case_convert	在 camelCase、snake_case、PascalCase 等格式之间转换
slugify	将字符串转换为适合 URL 的 slug
regex_test	根据输入测试正则表达式模式
text_diff	逐行比较两段文本

---

架构

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

技术栈： TypeScript + Node.js 22 · @modelcontextprotocol/sdk · bcryptjs · nanoid · zod

零外部 API 依赖。 所有工具都在本地运行，不会发起网络请求。

---

Docker

此镜像采用多阶段构建，以最大限度减小体积：

1. 构建阶段： 在 Node 22 Alpine 上编译 TypeScript
2. 运行阶段： 以非 root 用户身份在 Node 22 Alpine 上运行编译后的 JS

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

---

常见问题与设计理念

为什么选择 MCP，而不是直接使用库？

合理的质疑： 如果你在编写 Python 脚本，需要对内容进行哈希处理，hashlib 只需 2 行代码。为什么还要承担 MCP 的开销？

回答： 此服务针对多步骤工作流中的 AI Agent 进行了优化，而非面向编写代码的程序员：

1. AI 幻觉的成本远高于 MCP 开销 — AI 模型调用 MCP 工具需要 50ms（而调用库只需 1ms），这点开销微不足道；相比之下，模型可能会编造哈希值或使用错误的编码。
2. 可靠的工具语义 — MCP 会强制执行严格的工具契约。例如，jwt_decode 始终会返回支持时区的易读日期。
3. 普遍适用 — 任何兼容 MCP 的客户端都可以使用这些工具。Python 库只有在你的 Agent 基于 Python 时才能使用。
4. 多租户安全性 — MCP 提供明确的工具白名单，并会验证输入。

何时使用 DevUtils 而非其他方案

适合使用 DevUtils 的情况：

• 你正在使用 Claude、Cursor、VS Code Copilot、Windsurf 或任何兼容 MCP 的 AI 助手
• 你希望在 AI 工作流中执行可靠且经过验证的实用操作
• 你需要在一个软件包中使用 36 个工具

不适合使用 DevUtils 的情况：

• 你正在编写常规应用程序代码（请使用原生库）
• 你需要极致性能（直接调用库的速度更快）
• 你的 AI 客户端不支持 MCP

设计理念

• 小巧且专注： 36 个实用工具，零外部 API，容器约 50MB
• 安全优先： 非 root 用户、Alpine Linux、最小化攻击面
• 适合 AI： 命名一致（<domain>_<operation>）、严格的架构、易读的输出
• 客户端无关： 通过 stdio 传输，可与任何兼容 MCP 的客户端配合使用

---

可通过以下渠道获取

渠道	链接
官方 MCP 注册表	io.github.paladini/devutils-mcp-server — registry.modelcontextprotocol.io
npm	devutils-mcp-server
GitHub Packages	@paladini/devutils-mcp-server（在发布标签时双重发布）
GHCR（Docker）	ghcr.io/paladini/devutils-mcp-server
Glama	glama.ai/mcp/servers/paladini/devutils-mcp-server
Smithery	smithery.ai/server/devutils-mcp-server
Cursor / Claude 插件	devutils-cursor-plugin

---

参与贡献

问题和想法：GitHub Discussions

安全问题报告：请参阅 SECURITY.md。

1. Fork 此仓库
2. 创建你的功能分支（git checkout -b feat/amazing-tool）
3. 提交更改（git commit -m 'feat: add amazing tool'）
4. 推送到该分支（git push origin feat/amazing-tool）
5. 创建 Pull Request

请参阅 CHANGELOG.md。

---

License

MIT © Fernando Paladini