watchdealer-pavel_watchbase-mcp-server

🚀 WatchBase MCP 服务器

WatchBase MCP 服务器是一个基于 Model Context Protocol (MCP) 的服务器，它提供对 WatchBase 数据馈送 API 的访问，让开发者能够轻松查询手表元数据。

🚀 快速开始

本 MCP 服务器可帮助开发者通过 WatchBase 数据馈送 API 获取手表的详细信息。在使用前，您需要确保系统已安装 Node.js 和 npm，并拥有 WatchBase API 的访问权限和有效的 API 密钥。

✨ 主要特性

此 MCP 服务器公开了一系列工具，对应 WatchBase API 的不同端点，具体如下：

• search：可依据品牌名称、系列名称、手表名称和参考编号（匹配整个单词）对数据库进行搜索。
• search_refnr：能根据参考编号搜索数据库（允许部分匹配）。
• list_brands：用于检索数据库中所有手表品牌的列表。
• list_families：可为给定的品牌 ID 检索所有系列的列表。
• list_watches：根据品牌 ID（和可选系列 ID）检索特定手表的列表，还能按更新日期进行过滤。
• get_watch_details：根据手表的 WatchBase ID 检索其所有详细信息。

📦 安装指南

安装 Node.js 和 npm

您可以从 Node.js 下载页面 下载并安装 Node.js 和 npm。

克隆代码仓库

git clone [repository-url]

进入项目目录

cd watchbase-mcp-server

安装依赖项

npm install

启动服务器

npm start

🔧 配置说明

您需要在 config.json 文件中进行如下配置：

{
  "api_key": "your_api_key_here",
  "endpoint_url": "https://api.watchbase.com"
}

请务必将 your_api_key_here 替换为您自己的 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>

📚 详细文档

关于 WatchBase API

WatchBase 数据馈送 API 提供对手表信息的结构化访问权限，涵盖品牌、系列（收藏）、特定型号手表、参考编号、技术细节和图像等内容。开发者可借助该 API 将详细的手表数据集成到自己的应用程序中。更多相关信息可在 WatchBase API 文档 中查找。

📄 许可证

此 MCP 服务器项目遵循 MIT 许可证，详情请查阅 LICENSE 文件。

请注意，WatchBase 的服务条款同样适用于 API 的使用。