Watchdealer Pavel Watchbase MCP Server

🚀 WatchBase MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、WatchBase データフィード API へのアクセスを提供し、時計のメタデータを照会することができます。

🚀 クイックスタート

この MCP サーバーを使用することで、WatchBase API を通じて時計の詳細なデータを取得できます。以下のセクションでは、必要な準備、インストール手順、使用方法などを説明します。

✨ 主な機能

この MCP サーバーは、WatchBase API のエンドポイントに対応する以下のツールを公開しています。

• search: ブランド名、シリーズ名、時計名、およびリファレンス番号（完全一致）でデータベースを検索します。
• search_refnr: リファレンス番号でデータベースを検索します（部分一致を許可）。
• list_brands: データベース内のすべての時計ブランドのリストを取得します。
• list_families: 指定されたブランド ID に対応するすべてのシリーズのリストを取得します。
• list_watches: ブランド ID（およびオプションでシリーズ ID）に基づいて特定の時計のリストを取得します。更新日でフィルタリングすることもできます。
• get_watch_details: WatchBase ID を指定して特定の時計のすべての詳細情報を取得します。

📦 インストール

前提条件

この MCP サーバーを使用するには、以下が必要です。

1. システムに Node.js と npm がインストールされていること。
2. WatchBase API へのアクセス権と有効な API キー。

インストール手順

1. Node.js と npm をダウンロードしてインストールします。Node.js ダウンロードページ
2. この MCP サーバーのコードリポジトリをクローンします。

   git clone [repository-url]
   

3. プロジェクトディレクトリに移動します。

   cd watchbase-mcp-server
   

4. 依存関係をインストールします。

   npm install
   

5. サーバーを起動します。

   npm start
   

📚 ドキュメント

設定について

config.json ファイルで、以下の設定を行う必要があります。

{
  "api_key": "your_api_key_here",
  "endpoint_url": "https://api.watchbase.com"
}

your_api_key_here を自分の API キーに置き換えてください。

🔍 WatchBase API について

WatchBase データフィード API は、ブランド、シリーズ（コレクション）、特定の時計モデル、リファレンス番号、技術的詳細、および画像を含む時計情報への構造化されたアクセスを提供します。開発者はこの API を使用して、詳細な時計データを自分のアプリケーションに統合することができます。詳細は WatchBase API ドキュメント を参照してください。

💻 使用例

基本的な使用法

以下は、各ツールの使用例です。

search の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search</tool_name>
  <arguments>
    {
      "q": "priors court"
    }
  </arguments>
</use_mcp_tool>

search_refnr の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search_refnr</tool_name>
  <arguments>
    {
      "q": "P2/"
    }
  </arguments>
</use_mcp_tool>

list_brands の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_brands</tool_name>
  <arguments>
    {}
  </arguments>
</use_mcp_tool>

list_families の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_families</tool_name>
  <arguments>
    {
      "brand_id": 37
    }
  </arguments>
</use_mcp_tool>

list_watches の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_watches</tool_name>
  <arguments>
    {
      "brand_id": 37,
      "family_id": 279
    }
  </arguments>
</use_mcp_tool>

get_watch_details の使用例

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>get_watch_details</tool_name>
  <arguments>
    {
      "id": 17289
    }
  </arguments>
</use_mcp_tool>

📄 ライセンス

この MCP サーバープロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

なお、WatchBase のサービス利用規約も API の使用に適用されます。