WatchBase MCP サーバー
ウォッチメタデータを照会するための WatchBase データ フィード API へのアクセスを提供する MCP (モデル コンテキスト プロトコル) サーバー。
WatchBase APIについて
WatchBaseデータフィードAPIは、ブランド、ファミリー（コレクション）、特定の時計モデル、リファレンス番号、技術詳細、画像などを含む包括的な時計情報データベースへの構造化されたアクセスを提供します。開発者は、このAPIを使用して、詳細な時計データをアプリケーションに統合できます。詳細については、 WatchBase APIドキュメントをご覧ください。
Related MCP server: DARPEngine
特徴
この 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ページにアクセスしてアクセスをリクエストし、キーを取得してください。
インストール
リポジトリをクローンします。
git clone https://github.com/watchdealer-pavel/watchbase-mcp.git cd watchbase-mcp依存関係をインストールします:
npm installサーバーを構築します。
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
Cline / Roo Code（VS Code拡張機能）
MCPサーバーのVS Code設定を開きます。macOSの場合、通常は次の場所にあります:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json(注: 正確なパスは、オペレーティングシステムとVS Codeのインストールタイプによって異なる場合があります。Roo Codeの場合は、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 }
クロードデスクトップアプリ
Claudeデスクトップアプリの設定ファイルを開きます。macOSの場合、通常は次の場所にあります:
~/Library/Application Support/Claude/claude_desktop_config.json(注: 正確なパスはオペレーティングシステムによって異なる場合があります)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 の利用規約もご参照ください。