Watchbase MCP Server

🚀 WatchBase MCP サーバー

WatchBase データフィード API へのアクセス権を提供する MCP（モデルコンテキストプロトコル）サーバーです。時計のメタデータを照会するために使用できます。

🚀 クイックスタート

WatchBase MCP サーバーは、WatchBase データフィード API へのアクセスを提供し、時計のメタデータを簡単に照会できます。以下のセクションでは、サーバーの機能、インストール方法、設定方法、使用方法について詳しく説明します。

✨ 主な機能

この MCP サーバーは以下の機能を提供します：

1. 検索：クエリ文字列に基づいて時計を検索します。
2. リファレンス番号での検索：部分的なリファレンス番号（ワイルドカードをサポート）に基づいて時計を検索します。
3. ブランドの一覧表示：利用可能なすべてのブランドのリストを取得します。
4. シリーズの一覧表示：指定されたブランド ID に基づいて、そのブランドのシリーズリストを取得します。
5. 時計の一覧表示：ブランド ID とオプションのシリーズ ID に基づいて、特定のブランドおよび/またはシリーズの時計リストを取得します。
6. 時計の詳細情報の取得：指定された時計 ID を使用して、その時計の詳細情報を取得します。

📦 インストール

前提条件

• Node.js と npm をインストールする
• WatchBase API アクセスキーを取得する

インストール手順

1. GitHub からリポジトリをクローンします：

git clone https://github.com/your-repository.git

2. プロジェクトディレクトリで依存関係をインストールします：

npm install

3. 以下のコマンドを使用してサーバーをビルドします：

npm run build

📚 ドキュメント

設定

API_KEY 環境変数をあなたの WatchBase API アクセスキーに設定してください。

Cline/Roo Code 設定例

config.json ファイルに以下の内容を追加します：

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

Claude Desktop App 設定例

config.json ファイルに以下の内容を追加します：

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

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

また、API の使用に関する規定については、WatchBase サービス利用規約を参照してください。