Watchdealer Pavel Watchbase MCP Server

🚀 WatchBase MCP 服務器

WatchBase MCP 服務器是一個基於 Model Context Protocol (MCP) 的服務器，它提供了對 WatchBase 數據饋送 API 的訪問，可用於查詢手錶元數據，助力開發者將詳細的手錶數據集成到應用程序中。

🚀 快速開始

要使用此 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 密鑰。

✨ 主要特性

此 MCP 服務器公開以下工具，對應於 WatchBase API 的端點：

• search：根據品牌名稱、系列名稱、手錶名稱和參考編號（匹配整個單詞）搜索數據庫。
• search_refnr：根據參考編號搜索數據庫（允許部分匹配）。
• list_brands：檢索數據庫中所有手錶品牌的列表。
• list_families：為給定的品牌 ID 檢索所有系列的列表。
• list_watches：根據品牌 ID（和可選系列 ID）檢索特定手錶的列表。可以按更新日期進行過濾。
• get_watch_details：根據其 WatchBase ID 檢索特定手錶的所有詳細信息。

📚 詳細文檔

關於 WatchBase API

WatchBase 數據饋送 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 使用。