WatchBase MCP Server

WatchBase MCP サーバー

包括的な時計のメタデータを検索するための、WatchBase Data Feed APIへのアクセスを提供するMCP（Model Context Protocol）サーバーです。

WatchBaseとは？

WatchBaseは、高級時計に関する詳細情報を含む包括的な時計データベースです。次の情報が登録されています。

• 280以上のブランド（Rolex、Patek Philippe、Audemars Piguetなど）
• 数千の時計ファミリー／コレクション
• 技術仕様（ケースサイズ、ムーブメント、複雑機構など）
• 正確な識別に使うリファレンス番号

機能

このMCPサーバーは、WatchBase APIを検索するための6つのツールを提供します。

ツール	説明	必須パラメーター
search	ブランド、ファミリー、時計名、またはリファレンス番号で検索します（完全一致する単語）	q
search_refnr	リファレンス番号で検索します（部分一致可）	q
list_brands	データベース内のすべての時計ブランドを取得します	—
list_families	ブランドのファミリー／コレクションをすべて取得します	brand_id
list_watches	ブランド／ファミリーの時計を取得します（日付フィルターは任意）	brand_id
get_watch_details	特定の時計の詳細仕様を取得します	id

前提条件

• Node.js 18+（Node.js 25を含む）
• WatchBase APIキー — こちらからアクセスをリクエスト

クイックスタート

1. クローンしてインストール

git clone https://github.com/watchdealer-pavel/watchbase-mcp-server.git
cd watchbase-mcp-server
npm install

2. MCPクライアントを設定

MCPクライアントの設定に追加します。

Claude Desktop（~/Library/Application Support/Claude/claude_desktop_config.json）:

{
  "mcpServers": {
    "watchbase": {
      "command": "node",
      "args": ["/path/to/watchbase-mcp-server/build/index.js"],
      "env": {
        "WATCHBASE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code（プロジェクト内の.mcp.json）:

{
  "mcpServers": {
    "watchbase": {
      "command": "node",
      "args": ["/path/to/watchbase-mcp-server/build/index.js"],
      "env": {
        "WATCHBASE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. MCPクライアントを再起動

Claude DesktopまたはClaude Codeを再起動して、新しいMCPサーバーを読み込みます。

使用例

時計を検索する

Search for "Royal Oak" watches
→ Uses: search tool with q="Royal Oak"

リファレンス番号で検索する

Find watches with reference number starting with "15500"
→ Uses: search_refnr tool with q="15500"

ブランドとファミリーを閲覧する

List all Rolex families
→ Uses: list_brands to find Rolex ID, then list_families with brand_id

時計の仕様を取得する

Get full details for watch ID 12345
→ Uses: get_watch_details tool with id=12345

APIレスポンスの例

ブランドオブジェクト

{
  "id": 59,
  "name": "Audemars Piguet"
}

時計一覧のレスポンス

{
  "id": 11702,
  "refnr": "15500ST.OO.1220ST.01",
  "name": "Royal Oak",
  "brand": { "id": 59, "name": "Audemars Piguet" },
  "family": { "id": 234, "name": "Royal Oak" },
  "thumb": "https://cdn.watchbase.com/watch/medium/...",
  "updated": "2024-01-15"
}

時計詳細のレスポンス

次の項目を含むすべてのフィールドが含まれます。

• caliber — ムーブメントの詳細
• case — ケースの仕様
• dial — 文字盤の情報
• added、modified、published — メタデータの日付

時計販売店向け

このMCPサーバーは、次の用途に最適です。

1. 在庫管理 — リファレンス番号と仕様を調べる
2. 価格調査 — 詳細な仕様を取得して市場価格と比較する
3. 真贋確認 — リファレンス番号と仕様を確認する
4. コンテンツ作成 — 正確な時計の説明を作成する
5. カスタマーサービス — あらゆる時計についての質問にすばやく回答する

一般的なワークフロー

1. リファレンス番号で検索 — 一部のリファレンス番号を使ってsearch_refnrを呼び出す
2. 検索結果から時計IDを取得
3. 詳細情報を取得 — IDを使ってget_watch_detailsを呼び出す
4. リスティング、比較、調査に仕様を活用

大規模な在庫の増分同期

updated_sinceパラメーターを指定してlist_watchesを使うと、変更されたレコードのみを同期できます。

list_watches with brand_id=59, updated_since="2024-01-01"
→ Returns only watches updated after Jan 1, 2024

APIドキュメント

詳細なAPIドキュメントについては、watchbase_api_reference.mdをご覧ください。

開発

# Watch mode (auto-rebuild on changes)
npm run dev

# Manual build
npm run build

# Run the server directly
npm start

トラブルシューティング

「WATCHBASE_API_KEY environment variable is required」

WATCHBASE_API_KEYをMCPクライアントのenv設定に追加したことを確認してください。

「WatchBase API error: Invalid or unauthorized API key」

APIキーが無効か、期限切れの可能性があります。WatchBaseサポートにお問い合わせください。

Claudeにサーバーが表示されない

1. build/index.jsへのパスが正しいことを確認します
2. Claude Desktop／Codeを再起動します
3. 接続エラーがないかログを確認します

ライセンス

MIT License — LICENSEファイルをご覧ください。

注: このMCPサーバーは独立したプロジェクトです。API利用ポリシーについては、WatchBase Terms of Serviceをご確認ください。

リンク

• WatchBase Data Feed — API アクセスと料金
• WatchBase Website — 時計データベースを閲覧
• Model Context Protocol — MCP のドキュメント