Watchbase MCP Server

🚀 WatchBase MCP 服務器

WatchBase MCP 服務器是一個 MCP（模型上下文協議）服務器，它提供了對 WatchBase 數據 feed API 的訪問權限，可用於查詢手錶元數據，助力開發人員將詳細的手錶數據集成到自己的應用程序中。

🚀 快速開始

在使用 WatchBase MCP 服務器之前，你需要完成一些準備工作，包括安裝必要的軟件和獲取 API 訪問密鑰。

先決條件

• 安裝 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"
    }
  }
}

✨ 主要特性

此 MCP 服務器提供了豐富的功能，方便你對手錶數據進行查詢和管理：

1. 搜索：根據查詢字符串搜索手錶。
2. 按參考編號搜索：根據部分參考編號搜索手錶（支持通配符）。
3. 列出品牌：獲取所有可用品牌的列表。
4. 列出系列：根據指定的品牌 ID 獲取該品牌的系列列表。
5. 列出手錶：根據品牌 ID 和可選的系列 ID 獲取特定品牌和/或系列下的手錶列表。
6. 獲取手錶詳細信息：通過指定的手錶 ID 獲取其詳細信息。

📦 安裝指南

克隆倉庫

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

安裝依賴

npm install

構建服務器

npm run build

💻 使用示例

以下是每個工具的使用示例：

基礎用法

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>

📚 詳細文檔

關於 WatchBase API

WatchBase 數據 feed API 提供了對全面的手錶信息數據庫的結構化訪問，包括品牌、系列（收藏）、特定型號、參考編號、技術細節和圖像。它允許開發人員將其詳細的手錶數據集成到其應用程序中。更多相關信息請參閱 WatchBase API 文檔。

📄 許可證

此 MCP 服務器項目根據 MIT 許可證發佈 - 有關詳細信息，請參閱 LICENSE 文件。請同時參考 WatchBase 服務條款，瞭解 API 使用的相關規定。