Urdb : Product Integrity Database

urdb-mcp

面向 URDB 的 MCP 服务。为你的 AI 助手提供 76 种电子、硬件和固件计算器，以及用于追踪降级、缩水式通胀、保修缩水和产品质量恶化的产品诚信数据库。

询问 “在 16 MHz AVR 上实现 9600 波特率需要什么 UBRR？”，即可获得 103、误差百分比和详细推导，而不是一个听起来似乎合理的猜测。

设置

1. 获取 API 密钥，前往 urdb.io/settings/api-keys（提供免费套餐）

2. 添加到你的 MCP 宿主

Claude Desktop 配置文件位于 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。

{
  "mcpServers": {
    "urdb": {
      "command": "npx",
      "args": ["urdb-mcp"],
      "env": {
        "URDB_API_KEY": "urdb_live_your_key_here"
      }
    }
  }
}

3. 重启宿主

计算器的调用量与产品数据分开计量——免费套餐每天可调用 1,000 次计算器，因此 Agent 在进行设计时，不会因算术计算耗尽配额。

示例提示词

• “为 5 V 电源上的蓝色 LED 计算限流电阻”
• “列出 40 MHz 时钟下实现 500 kbit/s 的所有有效 CAN 位时序”
• “外层走线承载 3 A、电升温 20 °C 时需要多宽的走线？”
• “解码这个结构体在 32 位目标上的填充”
• “LoRa SF12 实现 1000 km 通信现实吗？”
• “哪些笔记本电脑的诚信评分最高？”
• “KitchenAid Stand Mixer 这些年来质量变差了吗？”

工具

调用 tools/list 查看当前工具集——计算器目录会在运行时从服务端获取，因此无需更新软件包即可扩充。

计算器

七个类别共 76 种工具，命名为 calc_<name>：

类别	涵盖内容
元器件（11）	电阻和电容色环／SMD 代码、E 系列取值、LED 电阻、RC 时间常数、串联／并联网络
电路（16）	555 定时器、运算放大器、滤波器、降压／升压转换器、MOSFET 栅极驱动、欧姆定律、齐纳和 LM317 稳压器、施密特触发器
电源与布线（13）	PCB 走线宽度和阻抗、线规、电压降、保险丝选型、散热器、电池组、太阳能系统选型、过孔电流
固件（22）	UART 波特率、CAN 位时序、PLL 分频器、定时器预分频器、CRC、IEEE 754、结构体填充、位域、看门狗、Intel HEX
射频与信号（7）	天线长度、LoRa 空中时间、路径损耗、VSWR、奈奎斯特、FFT 频点、波长
机械（4）	步进电机、E 步数、齿轮比、攻丝底孔尺寸
参考（3）	引脚排列、逻辑电平、MCU 对比

每个工具都会返回答案、机器可读值、详细推导，以及指向网页上同一工具的链接：https://urdb.io/tools/<name>。

产品数据

工具	描述
urdb_search	按名称或关键词搜索产品，并显示诚信评分
urdb_get_product	提供涵盖 7 个维度的完整诚信评估
urdb_get_changes	列出产品有记录的质量恶化事件
urdb_list_products	按类别、品牌或评分列出／筛选产品

工作原理

此软件包是一个轻量级的 stdio→HTTPS 代理，连接到 https://urdb.io/api/v1。它不包含任何计算逻辑：服务启动时，会从 /api/v1/tools 获取目录和每个工具的 JSON Schema。

这意味着，URDB 新增的计算器会在你下次重启后显示在这里；修复则通过部署送达，无需执行 npm update。如果 API 无法访问，服务仍会启动并提供产品工具，并在下次调用 tools/list 时重试获取目录。

如果存在已发布标准，计算器会遵循这些标准——走线几何遵循 IPC-2221 和 IPC-2141，E 系列遵循 IEC 60063，保险丝遵循 IEC 60127，CAN 遵循 ISO 11898-1，浮点数遵循 IEEE 754。如果结果是外推值而非测量值，工具会明确说明。

REST API

此处的所有内容都可通过普通 HTTP 访问：

curl -H "Authorization: Bearer $URDB_API_KEY" https://urdb.io/api/v1/tools

curl -X POST https://urdb.io/api/v1/tools/uart-baud-rate \
  -H "Authorization: Bearer $URDB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"clockHz": 16000000, "baud": 9600, "family": "avr-normal"}'

完整文档：urdb.io/api

配置

变量	必填	描述
URDB_API_KEY	是	你从 urdb.io/settings/api-keys 获取的密钥
URDB_API_URL	否	API 基础 URL。默认为 https://urdb.io/api/v1。

开发

npm run typecheck
npm run build     # bundle to dist/index.js
npm test          # stdio end-to-end against a mock API

许可证

MIT