WatchBase MCP Server

WatchBase MCP サーバー

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

WatchBase APIについて

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

特徴

この 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例

search_refnr例

list_brands例

list_families例

list_watches例

get_watch_details例

ライセンス

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

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