devtools-mcp

开发者工具包 MCP

五种高频开发实用工具，均作为 MCP 工具提供——UUID 生成、时间戳转换（北京时间）、单位转换、JSON 格式化/校验和二维码生成。所有操作均在本地运行；五种工具中有四种仅使用 Python 标准库。

• 30 秒即可试用：免费的公共 MCP 端点已在运行——只需将 URL 粘贴到 MCP 客户端中（无需安装，也无需 API 密钥）。
• 也可自托管：轻量级 FastMCP 服务，不调用外部 API，结果确定且保护隐私。

⚡ 使用托管端点（无需设置）

https://mcp.pianam.cn/devtools-mcp/mcp

传输方式：Streamable HTTP（兼容 MCP 2025-03-26）。无需身份验证。

🔌 客户端配置

将以下内容添加到 MCP 客户端的 mcpServers 配置中（Claude Desktop、Cursor、Cline、Cherry Studio 等）：

{
  "mcpServers": {
    "devtools": {
      "type": "http",
      "url": "https://mcp.pianam.cn/devtools-mcp/mcp"
    }
  }
}

不接受 "type": "http" 的客户端，可使用仅包含 "url" 的相同配置项。

🧰 工具

| 工具 | 参数 | 返回值 | |

---|---|---| | generate_uuid(version="v4", count=1, namespace=null, name=null) | version：v4 随机生成（默认）或 v5 命名空间 SHA-1。count：1–1000。v5 需要：namespace（dns/url/oid/x500 或完整 UUID）和 name。 | UUID 字符串列表（相同的命名空间和名称会生成确定性的 v5 UUID）。 | | convert_timestamp(value=null, to="iso") | value：Unix 时间戳，单位为秒或毫秒（自动检测，整数或数字字符串），或日期/时间字符串（2026-09-05、2026-09-05 10:30:00、ISO 8601 等）。省略时使用“当前时间”。 | ISO 8601 北京时间字符串、易读格式、Unix 秒/毫秒和星期；也可将日期字符串反向转换。所有时间均使用 Asia/Shanghai（UTC+8）。 | | convert_unit(value, from_unit, to_unit) | 数值 value 和单位，涵盖长度（m/km/cm/mm/mile/foot/inch 等）、重量（kg/g/mg/t/lb/oz 等）、温度（c/f/k，含偏移量）、数据存储（B/KB/MB/GB/TB/PB，二进制 1024）。也接受中文单位名称。 | 转换结果及易读的算式；跨类别转换（例如米转换为千克）会返回明确错误。 | | format_json(data, action="format") | data：JSON 字符串。action：format（美化，缩进 2 个空格，不转义中文）/minify/validate。 | 格式化/压缩后的文本及长度对比，或有效性判定；遇到无效 JSON 时，会返回错误行/列、位置指示符和上下文片段。 | | generate_qr(content, format="svg") | content：URL/文本/WiFi 字符串（≤ 2000 字节）。format：svg（默认，矢量）或 png。 | SVG 标记字符串（保存为 .svg；Agent 可直接写入文件），或 PNG 的 base64 + data URI（PNG 需要 Pillow）。 |

示例

• “生成 5 个 UUID” / “给域名 example.com 生成一个 v5 UUID”
• “把时间戳 1788000000 转成北京时间” / “2026-10-01 09:00 的 Unix 时间戳是多少”
• “10 英里等于多少公里” / “98.6 华氏度转摄氏度” / “1 GB 等于多少 MB”
• “帮我美化这段 JSON 并检查有没有语法错误”
• “把 https://example.com 生成二维码”

📡 依赖项与隐私

• generate_uuid、convert_timestamp、convert_unit、format_json 仅使用 Python 标准库。
• generate_qr 使用纯 Python 的 qrcode 包及其 SVG 路径图像工厂——SVG 输出无需 Pillow/原生依赖。PNG 输出为可选项，需要 Pillow。
• 零网络调用、零 API 密钥——完全确定性，适合处理敏感数据。

🐢 自托管

git clone https://github.com/boy-373/devtools-mcp.git
cd devtools-mcp
pip install -r requirements.txt
python server.py
# listens on 127.0.0.1:8000 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py
# behind a reverse proxy, allow your public hostname:
#   MCP_ALLOWED_HOSTS="your-domain.com,your-domain.com:*" python server.py

然后将 MCP 客户端指向 http://127.0.0.1:8000/mcp。

使用 uv：

uv venv && uv pip install -r requirements.txt
uv run python server.py

🗂️ Files

• devtools_server.py — the MCP server: all five tools and FastMCP definitions.
• server.py — standalone Streamable HTTP entry point (serves the MCP app at /mcp).
• requirements.txt — Python dependencies.
• LICENSE — MIT.

---

🇨🇳 中文说明

开发者工具包 MCP：五个高频小工具 —— UUID 生成（v4/v5）、时间戳双向转换（统一北京时间 UTC+8）、单位换算（长度/重量/温度/数据存储）、JSON 美化/压缩/校验（带错误定位）、二维码生成（默认矢量 SVG，可选 PNG）。

在线直连（免费、无需 Key）：https://mcp.pianam.cn/devtools-mcp/mcp

前四个工具仅用 Python 标准库；二维码用纯 Python 的 qrcode 生成 SVG（PNG 才需 Pillow）。全程无任何网络请求与外部 API，确定性、隐私安全。

📄 License

MIT © 2026 boy-373 (刘扶阳)