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 の設定ファイルは、macOS では ~/Library/Application Support/Claude/claude_desktop_config.json、Windows では %APPDATA%\Claude\claude_desktop_config.json にあります。

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

3. ホストを再起動する

計算ツールの使用量は製品データとは別に計測されます。無料プランでは 1 日に 1,000 回の計算ツール呼び出しが可能なため、設計作業を進めるエージェントが計算だけで割り当てを使い切ることはありません。

プロンプトの例

• 「5 V の青色 LED 用に、電流制限抵抗の値を決めてください」
• 「40 MHz クロックで 500 kbit/s を実現する、有効な CAN ビットタイミングをすべて教えてください」
• 「外層で温度上昇を 20 °C に抑えて 3 A を流すには、トレース幅をどれくらいにすればよいですか？」
• 「この構造体の、32 ビットターゲットでのパディングをデコードしてください」
• 「LoRa SF12 で 1000 km の通信は現実的ですか？」
• 「整合性スコアが最も高いノートパソコンはどれですか？」
• 「KitchenAid Stand Mixer は、長年の間に品質が低下しましたか？」

ツール

現在のツール一覧を確認するには tools/list を呼び出してください。計算ツールのカタログは実行時にサーバーから取得されるため、パッケージを更新しなくても追加されます。

計算ツール

7 つのカテゴリにわたる 76 個のツールがあり、calc_<name> という名前が付けられています。

カテゴリ	内容
コンポーネント（11）	抵抗器やコンデンサーのカラーコード／SMD コード、E 系列への丸め、LED 用抵抗、RC 時定数、直列／並列回路
回路（16）	555 タイマー、オペアンプ、フィルター、降圧／昇圧コンバーター、MOSFET ゲート駆動、オームの法則、ツェナーおよび LM317 レギュレーター、シュミットトリガー
電力と配線（13）	PCB のトレース幅とインピーダンス、電線サイズ、電圧降下、ヒューズ選定、ヒートシンク、バッテリーパック、太陽光発電の容量設計、ビア電流
ファームウェア（22）	UART ボーレート、CAN ビットタイミング、PLL 分周器、タイマープリスケーラー、CRC、IEEE 754、構造体パディング、ビットフィールド、ウォッチドッグ、Intel HEX
RF と信号（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	カテゴリ、ブランド、スコアで製品を一覧表示／絞り込みます

仕組み

このパッケージは、https://urdb.io/api/v1 への薄い stdio→HTTPS プロキシです。計算ロジックは含まず、サーバーの起動時にカタログと各ツールの JSON Schema を /api/v1/tools から取得します。

そのため、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