🚀 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 使用。