WatchBase MCP サーバー

ウォッチメタデータを照会するための WatchBase データ フィード API へのアクセスを提供する MCP (モデル コンテキスト プロトコル) サーバー。

WatchBase APIについて

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

Related MCP server: mcp-mediawiki-crunchtools

特徴

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

• search : ブランド名、ファミリー名、時計名、参照番号でデータベースを検索します (単語全体が一致します)。

• search_refnr : 参照番号でデータベースを検索します (部分一致を許可します)。

• list_brands : データベース内のすべての時計ブランドのリストを取得します。

• list_families : 指定されたブランド ID のすべてのファミリー (コレクション) のリストを取得します。

• list_watches : 特定のブランドID（オプションでファミリーID）の時計リストを取得します。更新日でフィルタリングできます。

• get_watch_details : WatchBase ID によって特定のウォッチの完全な詳細 (すべてのデータ フィールド) を取得します。

前提条件

• **Node.js および npm:**依存関係をインストールしてサーバーを実行するために必要です。

• WatchBase APIキー： WatchBaseのAPIキーが必要です。WatchBase APIページにアクセスしてアクセスをリクエストし、キーを取得してください。

インストール

1. リポジトリをクローンします。

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

2. 依存関係をインストールします:

   npm install

3. サーバーを構築します。

   npm run build

   このコマンドは、TypeScript ソース コードを JavaScript にコンパイルし、出力をbuild/ディレクトリ (具体的にはbuild/index.js ) に配置します。

構成

このサーバーは、環境変数WATCHBASE_API_KEYを介して WatchBase API キーを提供する必要があります。このサーバーを実行するには、MCP クライアント（Cline/Roo Code や Claude デスクトップアプリなど）を設定し、環境変数を渡す必要があります。

構成例:

以下は一般的なMCPクライアントの例です。/path/to/your/watchbase-mcp/build/index.js /path/to/your/watchbase-mcp/build/index.jsシステム上のコンパイル済みサーバーファイルへの実際の絶対パスに置き換え、 YOUR_WATCHBASE_API_KEY実際のWatchBase APIキーに置き換えてください。

Cline / Roo Code（VS Code拡張機能）

1. MCPサーバーのVS Code設定を開きます。macOSの場合、通常は次の場所にあります: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json(注: 正確なパスは、オペレーティングシステムとVS Codeのインストールタイプによって異なる場合があります。Roo Codeの場合は、 saoudrizwan.claude-devをrooveterinaryinc.roo-clineに置き換えてください)

2. mcpServersキーの下に次の構成ブロックを追加します。

   "watchbase-mcp": {
     "command": "node",
     "args": ["/path/to/your/watchbase-mcp/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js
     "env": {
       "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- IMPORTANT: Replace with your WatchBase API Key
     },
     "disabled": false,
     "autoApprove": [] // Or add specific tools you want to auto-approve
   }

クロードデスクトップアプリ

1. Claudeデスクトップアプリの設定ファイルを開きます。macOSの場合、通常は次の場所にあります: ~/Library/Application Support/Claude/claude_desktop_config.json(注: 正確なパスはオペレーティングシステムによって異なる場合があります)

2. mcpServersキーの下に次の構成ブロックを追加します。

   "watchbase-mcp": {
     "command": "node",
     "args": ["/path/to/your/watchbase-mcp/build/index.js"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js
     "env": {
       "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- IMPORTANT: Replace with your WatchBase API Key
     },
     "disabled": false,
     "autoApprove": [] // Or add specific tools you want to auto-approve
   }

使用法

設定が完了すると、 use_mcp_toolコマンド/ツールを使用して AI アシスタントからサーバーのツールを呼び出すことができます。

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ファイルを参照してください。

API のご利用に関しては WatchBase の利用規約もご参照ください。