# devbelt-mcp

**Repository Path**: regaing/devbelt-mcp

## Basic Information

- **Project Name**: devbelt-mcp
- **Description**: AI 开发工具 MCP server，提供 超过150 个在线工具（编码/加解密/代码格式化/JSON/文本/单位换算/网络查询/二维码等），以标准 MCP（Model Context Protocol）工具形式提供给 LLM 调用。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-08-10
- **Last Updated**: 2026-08-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <a href="README.md">中文</a> · <a href="README.en.md">English</a>
</p>

<div align="center">

# 🧰 devbelt-mcp

**给 AI 助手的「在线工具箱」—— 77 个常用小工具，AI 一句话就能调用**

JSON 处理 · 加解密 · 代码格式化 · 文本转换 · 单位换算 · 网络查询 · 二维码生成

![npm version](https://img.shields.io/npm/v/@lingxi-agent/devbelt-mcp?color=cb3837&label=npm)
![license](https://img.shields.io/badge/license-MIT-brightgreen)
![language](https://img.shields.io/badge/language-TypeScript-3178c6)
![node](https://img.shields.io/badge/node-%3E%3D18-339933)
![mcp](https://img.shields.io/badge/MCP-stdio-8b5cf6)
![tools](https://img.shields.io/badge/tools-77%20tools%20%7C%20170%2B%20capabilities-4fc3f7)
![tests](https://img.shields.io/badge/tests-97%20passing-2ea44f)

</div>

## 📖 这是什么？

`devbelt-mcp` 把站长/开发者常用的 **77 个在线小工具**（共 **170+ 项细分能力**）打包成 **AI 可以直接调用的接口**——就像给 AI 配了一个在线工具箱。

接入 AI 客户端（LingXi / Claude Desktop 等）后，直接对 AI 说人话即可，AI 会自动调用对应工具。比如「把这段 JSON 格式化一下」，AI 就会调用 `json_process` 完成——**全程不需要你写任何代码**。更多提问示例见下方 [💬 示例提问](#-示例提问)。

### 工具箱里有什么

- **JSON 工具**：格式化/压缩/校验、JSON↔XML/YAML/GET 参数、生成 C#/Java/Go 实体类
- **加解密**：MD5/SHA/HMAC 哈希、AES-GCM/CBC 对称加解密、摩尔斯电码、迅雷/快车 URL 加解密
- **代码工具**：18 种语言格式化与压缩、JS 混淆、正则测试/生成、XPath 提取
- **文本转换**：简繁互转、拼音、全角半角、竖排、去重、火星文、UUID 生成、身份证解析等 15 种
- **单位换算**：长度/面积/温度/速度/压力/数据大小等 13 类
- **网络查询**：WHOIS、ICP 备案、IP 归属、DNS 解析、HTTP 状态、Gzip 检测、死链检测、网页抓取、WebSocket 完整会话测试
- **时间工具**：时间戳互转、多时区对照、时间差/倒计时、cron 解析、时长换算、strftime 格式化
- **其他**：二维码/条形码/ICO 图标生成、万年历、17 类参考表查询

### 技术底座

基于 **MCP**（Model Context Protocol，AI 调用外部工具的开放标准，可以理解为"AI 的 USB-C"），通过 **stdio** 与本地 AI 客户端直连。全部工具在本地运行，零数据库，无外部服务依赖（除工信部 ICP 接口）。

> 💡 推荐使用 **灵犀 AI 智能助手**（[https://lingxi.regaing.com](https://lingxi.regaing.com)）接入本服务，获得 77 个在线工具 · 170+ 项细分能力的完整 AI 体验。

## 💬 示例提问

接入后直接对 AI 说这些话，AI 会自动调用对应工具：

### JSON 与编码

| 提问 | 工具 |
|---|---|
| “把这段 JSON 格式化一下 / 压缩成一行” | `json_process` |
| “这个 JSON 是否合法？” | `json_process` |
| “把 JSON 转成 YAML / XML / GET 参数” | `json_convert` |
| “用这段 JSON 生成 Java / C# / Go 实体类” | `json_entity` |
| “把这段文字转成 Base64 / URL 编码” | `encode_base64` / `encode_url` |
| “把 255 转成 16 进制” | `encode_radix` |

### 加解密

| 提问 | 工具 |
|---|---|
| “算一下 hello 的 MD5 / SHA-256” | `crypto_hash` |
| “用密码 abc123 加密这段文字” | `crypto_symmetric` |
| “解密这段 AES 密文（密钥是 xxx）” | `crypto_symmetric` |
| “把 SOS 转成摩尔斯电码” | `crypto_morse` |
| “把这个迅雷链接还原成普通地址” | `crypto_download_url` |
| “#FF0000 是什么颜色，转成 RGB” | `color_convert` |

### 代码

| 提问 | 工具 |
|---|---|
| “格式化这段 Python / JS / SQL 代码” | `code_format` |
| “压缩这段 CSS / HTML” | `code_format` |
| “这个正则能匹配这段文本吗？” | `regex_tool` |
| “用正则提取所有邮箱地址” | `regex_tool` |
| “生成 Go 语言的正则代码” | `regex_generate` |
| “用 XPath 提取网页里的标题” | `xpath_tool` |

### 文本

| 提问 | 工具 |
|---|---|
| “把这段话转成繁体 / 简体” | `text_jianfan` |
| “这些汉字怎么读，转成拼音” | `text_pinyin` |
| “统计这段文字的字数” | `text_stats` |
| “生成一个 16 位随机密码” | `text_random` |
| “生成 5 个 UUID” | `uuid_generate` |
| “把这段文本按行去重” | `text_dedup` |

### 单位换算

| 提问 | 工具 |
|---|---|
| “1 英里等于多少公里？” | `unit_convert` |
| “100 摄氏度等于多少华氏度？” | `unit_convert` |
| “5 GB 等于多少 MB？” | `unit_convert` |

### 网络查询

| 提问 | 工具 |
|---|---|
| “查一下 example.com 的 WHOIS 信息” | `net_whois` |
| “example.com 有没有 ICP 备案？” | `net_icp` |
| “检测这个网站是否开启了 Gzip” | `net_gzip_check` |
| “抓取这个网页的内容” | `net_fetch` |
| “检测 https://example.com 有哪些死链” | `net_dead_link` |
| “测试这个 WebSocket 服务通不通” | `net_websocket_test` |

### 生成与查询

| 提问 | 工具 |
|---|---|
| “生成一个内容为 xxx 的二维码” | `misc_qrcode` |
| “生成 CODE128 条形码” | `misc_barcode` |
| “把这张 PNG 转成 ICO 图标” | `misc_favicon` |
| “HTTP 404 状态码是什么意思？” | `misc_reference` |
| “常见的公共 DNS 有哪些？” | `misc_reference` |

## ✨ 特性

- 🚀 **77 个工具 · 170+ 项细分能力**：编码转换 / 加解密 / 代码格式化 / JSON / 文本处理 / 单位换算 / 网络查询 / 二维码（如 `crypto_hash` 一个工具覆盖 12 种哈希算法，`code_format` 覆盖 18 种语言）
- 🧩 **现代加密标准**：AES-GCM/CBC（`node:crypto`），无历史算法残留
- ⚡ **stdio 直连**：本地运行、零数据库、无状态
- 🛡️ **统一错误处理**：异常自动转为可读文本，不抛裸堆栈
- ✅ **97 个端到端测试**：InMemoryTransport 连接真实 server，含 golden 回归

## 🚀 快速开始

```bash
npm install
npm run build        # 编译到 dist/
npm test             # 运行 97 个端到端测试
node dist/index.js   # 启动 stdio server
```

### 调用示例

```json
{
  "mcpServers": {
    "devbelt-mcp": {
      "command": "npx",
      "args": ["-y", "@lingxi-agent/devbelt-mcp"]
    }
  }
}
```

接入后 LLM 可直接调用，例如：

```
crypto_hash(text: "abc", algorithm: "md5")
  → 900150983cd24fb0d6963f7d28e17f72

unit_convert(category: "temperature", value: 100, from: "C", to: "F")
  → 100 C = 212 F（温度换算）

net_websocket_test(url: "wss://echo.websocket.org", messages: ["hello"], ping: true)
  → ✓ 连接成功 / → 发送：hello / ← 收到：hello / ✓ 收到 pong / ◼ 连接关闭
```

## 📦 客户端接入（LingXi / Claude Desktop 等）

**方式一：npx（推荐）**

```json
{
  "mcpServers": {
    "devbelt-mcp": {
      "command": "npx",
      "args": ["-y", "@lingxi-agent/devbelt-mcp"]
    }
  }
}
```

**方式二：本地 node 直接运行（开发/未发布时）**

```json
{
  "mcpServers": {
    "devbelt-mcp": {
      "command": "node",
      "args": ["W:/Project/devbelt-mcp/dist/index.js"]
    }
  }
}
```

## 🧰 工具清单（77 个工具 · 170+ 项细分能力）

### 编码转换 `encode_*`（9）
| 工具 | 功能 |
|---|---|
| `encode_url` | URL 编码/解码 |
| `encode_base64` | Base64 文本/图片互转 |
| `encode_unicode` | Unicode（\uXXXX）互转 |
| `encode_utf8` | UTF-8 编码/解码（%XX 形式） |
| `encode_ascii` | ASCII 编码/解码 |
| `encode_escape` | Escape 编码/解码 |
| `encode_radix` | 任意进制互转（2~36，支持大数） |
| `encode_detect` | 文本编码检测（UTF-8/GBK/GB2312 等） |
| `encode_html` | HTML 实体编解码（&lt;&gt;&amp; 等） |

### 加解密 `crypto_*`（8）
| 工具 | 功能 |
|---|---|
| `crypto_hash` | MD5（16/32位）/SHA 系列/HMAC |
| `crypto_symmetric` | AES 对称加解密：GCM/CBC（现代标准） |
| `crypto_morse` | 摩尔斯电码（中文自动转拼音） |
| `crypto_download_url` | 迅雷/快车/旋风下载地址加解密 |
| `color_convert` | HEX ↔ RGB 颜色转换 |
| `crypto_jwt` | JWT 编解码与校验（HS256） |
| `crypto_rsa` | RSA 非对称加解密/签名（生成密钥对/加密/解密/签名/验签） |
| `crypto_password_hash` | bcrypt 密码哈希与校验 |

### 代码工具 `code_*`（5）
| 工具 | 功能 |
|---|---|
| `code_format` | 18 种语言格式化/压缩（prettier + sql-formatter） |
| `code_obfuscate` | JS 混淆/美化（单向，禁止恶意用途） |
| `regex_tool` | 正则测试/提取/替换 |
| `regex_generate` | 7 种语言正则代码生成 |
| `xpath_tool` | 简易 XPath 提取 |

### JSON `json_*`（5）
`json_process`（格式化/压缩/转义/校验）、`json_convert`（↔XML/YAML/GET 参数）、`json_entity`（生成 C#/Java/Go 实体类，SQL→Java）、`json_path`（JSONPath 提取）、`json_schema_validate`（JSON Schema 校验）

### 数据转换 `data_*`（5）
`data_html_convert`（HTML↔JS/PHP/C#/JSP/ASP/Perl/UBB/Markdown）、`data_html_table`（CSV/JSON→HTML 表格）、`data_excel_json`（Excel↔JSON）、`data_text_diff`（文本差异）、`data_csv`（CSV 解析/生成）

### 文本处理 `text_*`（16）
大小写、简繁互转、拼音、全角半角、翻转、竖排、字数统计、去重、替换、HTML 过滤、自动排版、随机数/密码、火星文、UUID/GUID 生成、`text_idcard`（身份证解析）、`text_password_strength`（密码强度评估）

### 单位换算 `unit_convert`（1）
13 类单位：长度/面积/体积/速度/压力/功率/热量/力/时间/数据大小/角度/密度/温度

### 网络查询 `net_*`（14）
| 工具 | 功能 | 依赖 |
|---|---|---|
| `net_whois` | WHOIS 查询（**原生实现**，连 whois.iana.org 递归） | 无第三方 |
| `net_icp` | ICP 备案查询（工信部官方接口） | 工信部 |
| `net_ip_info` | IP 信息（本机网卡 / 归属地，内置精简段表） | **纯本地** |
| `net_dns_query` | DNS 解析（A/AAAA/CNAME/MX/TXT/NS/SOA/PTR，可指定 DNS） | **node:dns 原生** |
| `net_url_status` | HTTP 状态/响应头检测 | 直接请求 |
| `net_gzip_check` | Gzip 压缩检测 | 直接请求 |
| `net_dead_link` | 网站死链检测 | 直接请求 |
| `net_fetch` | 网页抓取（自动 GBK/UTF-8 解码） | 直接请求 |
| `net_meta_analyze` | Meta 标签分析 | 直接请求 |
| `net_keyword_density` | 关键词密度检测 | 直接请求 |
| `net_websocket_test` | WebSocket 完整会话（消息收发/ping RTT/wait_for） | ws 包 |
| `net_http_request` | HTTP 请求调试（curl 等价：JSON 序列化/multipart 上传/重定向/超时） | 原生 fetch |
| `net_ssl_check` | SSL 证书检查（有效期/签发者/链） | node:tls |
| `net_port_check` | TCP 端口连通检测（tcping 等价） | node:net |

### 其他 `misc_*`（8）
`misc_barcode`（条形码）、`misc_qrcode`（二维码）、`misc_qrcode_decode`（二维码解码）、`misc_calc`（数学表达式计算）、`misc_favicon`（PNG→ICO）、`misc_shortcut`（桌面快捷方式）、`misc_reference`（17 类参考表查询）、`misc_calendar`（万年历：农历/干支/生肖/节气/节日/宜忌，lunar-typescript 纯本地）

### 时间 `time_*`（6）
| 工具 | 功能 |
|---|---|
| `time_timestamp` | 时间戳↔日期互转（秒/毫秒/微秒/纳秒自动识别、多格式输入、UTC/本地/自定义时区） |
| `time_convert` | 多时区时间对照（北京/东京/伦敦/纽约等常用城市 + 自定义 ±HH:mm） |
| `time_diff` | 时间差/倒计时（各精度 + 人类可读 + 组件分解） |
| `time_cron` | cron 表达式解析（人类可读描述 + 未来 N 次执行时间） |
| `time_duration` | 时长人类可读化（双向：秒↔"1天2小时3分4秒"） |
| `time_format` | strftime 自定义格式化（YYYY/MM/DD/ddd/Q + %Y-%m-%d 兼容） |
## 🏗️ 设计说明

- **聚合粒度**：算法同族共用 schema（如 `crypto_hash(text, algorithm)` 覆盖 MD5/SHA 全家），77 个工具覆盖全部工具类型
- **统一错误处理**：所有工具异常返回可读错误文本（含可选参数提示），不会抛裸堆栈
- **现代加密**：对称加密基于 `node:crypto`（AES-GCM/CBC 等现代标准）
- **静态参考表**：17 类对照表（HTTP 状态码/端口/DNS/朝代/民族等）收敛为 `misc_reference` 一个工具

## 🧪 测试

```bash
npm test
```

97 个端到端测试（InMemoryTransport 连接真实 server）覆盖：
- 全部 77 个工具调用
- 标准输入输出回归（`md5('abc')`、进制转换、单位换算等）
- 本地 mock HTTP/WebSocket 服务验证网络工具
- 错误路径（非法参数、解密失败、连接失败）

## ⚠️ 已知限制

- `net_icp` 依赖工信部接口（`hlwicpfwc.miit.gov.cn`），接口变动时工具会返回可读错误
- `code_format` 对 php/java/c/cpp 等语言为基础缩进美化（非完整 AST 格式化）
- `xpath_tool` 为轻量正则实现，不支持复杂轴表达式

## 📄 License

[MIT](./LICENSE) © 2026 [@lingxi-agent](https://www.npmjs.com/org/lingxi-agent)