{
  "markdown": "# Developer Toolkit MCP\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)\n[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)\n[![Remote](https://img.shields.io/badge/Streamable%20HTTP-hosted%20free-success)](https://mcp.pianam.cn/devtools-mcp/mcp)\n\nFive high-frequency developer utilities as MCP tools — **UUID generation, timestamp conversion (Beijing time), unit conversion, JSON formatting/validation, and QR-code generation**. Everything runs locally; four of the five tools use only the Python standard library.\n\n- **Try it in 30 seconds**: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).\n- **Or self-host**: a tiny FastMCP server, no external API calls, deterministic and privacy-safe.\n\n## ⚡ Use the hosted endpoint (no setup)\n\n```\nhttps://mcp.pianam.cn/devtools-mcp/mcp\n```\n\nTransport: **Streamable HTTP** (MCP 2025-03-26 compatible). No authentication required.\n\n## 🔌 Client configuration\n\nAdd this to your MCP client's `mcpServers` configuration (Claude Desktop, Cursor, Cline, Cherry Studio, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"devtools\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.pianam.cn/devtools-mcp/mcp\"\n    }\n  }\n}\n```\n\n> Clients that do not accept `\"type\": \"http\"` accept the same entry with just `\"url\"`.\n\n## 🧰 Tools\n\n| Tool | Parameters | Returns |\n|\n\n[![devtools-mcp MCP server](https://glama.ai/mcp/servers/boy-373/devtools-mcp/badges/score.svg)](https://glama.ai/mcp/servers/boy-373/devtools-mcp)\n\n---|---|---|\n| `generate_uuid(version=\"v4\", count=1, namespace=null, name=null)` | `version`: `v4` random (default) or `v5` namespaced SHA-1. `count`: 1–1000. For v5: `namespace` (`dns`/`url`/`oid`/`x500` or a full UUID) + `name`. | List of UUID strings (v5 is deterministic for the same namespace+name). |\n| `convert_timestamp(value=null, to=\"iso\")` | `value`: Unix timestamp in seconds or milliseconds (auto-detected, int or numeric string) **or** a date/time string (`2026-09-05`, `2026-09-05 10:30:00`, ISO 8601…). Omit for \"now\". | ISO 8601 Beijing-time string + readable form + Unix seconds/milliseconds + weekday; or the reverse conversion from a date string. All times use Asia/Shanghai (UTC+8). |\n| `convert_unit(value, from_unit, to_unit)` | Numeric `value` and units across **length** (m/km/cm/mm/mile/foot/inch…), **weight** (kg/g/mg/t/lb/oz…), **temperature** (c/f/k, with offset), **data storage** (B/KB/MB/GB/TB/PB, binary 1024). Chinese unit names also accepted. | Converted result plus a readable equation; cross-category conversion (e.g. meters to kilograms) returns a clear error. |\n| `format_json(data, action=\"format\")` | `data`: JSON string. `action`: `format` (pretty, 2-space indent, Chinese unescaped) / `minify` / `validate`. | Formatted/minified text with length comparison, or a validity verdict; on invalid JSON returns error line/column, a position pointer and a context snippet. |\n| `generate_qr(content, format=\"svg\")` | `content`: URL/text/WiFi string (≤ 2000 bytes). `format`: `svg` (default, vector) or `png`. | SVG markup string (save as `.svg`; an agent can write the file directly) or, for PNG, base64 + data URI (PNG requires Pillow). |\n\n### Examples\n\n- \"生成 5 个 UUID\" / \"给域名 example.com 生成一个 v5 UUID\"\n- \"把时间戳 1788000000 转成北京时间\" / \"2026-10-01 09:00 的 Unix 时间戳是多少\"\n- \"10 英里等于多少公里\" / \"98.6 华氏度转摄氏度\" / \"1 GB 等于多少 MB\"\n- \"帮我美化这段 JSON 并检查有没有语法错误\"\n- \"把 https://example.com 生成二维码\"\n\n## 📡 Dependencies & privacy\n\n- `generate_uuid`, `convert_timestamp`, `convert_unit`, `format_json` use **only the Python standard library**.\n- `generate_qr` uses the pure-Python [`qrcode`](https://pypi.org/project/qrcode/) package with its SVG path image factory — SVG output needs **no Pillow/native deps**. PNG output is optional and requires Pillow.\n- **Zero network calls, zero API keys** — fully deterministic and safe for sensitive data.\n\n## 🐢 Self-hosting\n\n```bash\ngit clone https://github.com/boy-373/devtools-mcp.git\ncd devtools-mcp\npip install -r requirements.txt\npython server.py\n# listens on 127.0.0.1:8000 by default; override with:\n#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python server.py\n# behind a reverse proxy, allow your public hostname:\n#   MCP_ALLOWED_HOSTS=\"your-domain.com,your-domain.com:*\" python server.py\n```\n\nThen point your MCP client at `http://127.0.0.1:8000/mcp`.\n\nWith [uv](https://docs.astral.sh/uv/):\n\n```bash\nuv venv && uv pip install -r requirements.txt\nuv run python server.py\n```\n\n## 🗂️ Files\n\n- `devtools_server.py` — the MCP server: all five tools and FastMCP definitions.\n- `server.py` — standalone Streamable HTTP entry point (serves the MCP app at `/mcp`).\n- `requirements.txt` — Python dependencies.\n- `LICENSE` — MIT.\n\n---\n\n## 🇨🇳 中文说明\n\n开发者工具包 MCP：五个高频小工具 —— **UUID 生成（v4/v5）、时间戳双向转换（统一北京时间 UTC+8）、单位换算（长度/重量/温度/数据存储）、JSON 美化/压缩/校验（带错误定位）、二维码生成（默认矢量 SVG，可选 PNG）**。\n\n**在线直连（免费、无需 Key）**：`https://mcp.pianam.cn/devtools-mcp/mcp`\n\n前四个工具仅用 Python 标准库；二维码用纯 Python 的 `qrcode` 生成 SVG（PNG 才需 Pillow）。全程无任何网络请求与外部 API，确定性、隐私安全。\n\n## 📄 License\n\n[MIT](LICENSE) © 2026 boy-373 (刘扶阳)\n",
  "bytes": 5097,
  "sha": "536aea9a7007420267c1669bbd91f70b05d7cec894acd769858ad43c9450b41d",
  "repo_slug": "boy-373/devtools-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_cn_pianam_mcp_devtools_mcp_26cab316/readme"
}