WatchBase MCP Server
2025.04.21
0
JavaScript手表数据查询API 集成搜索工具数据库
WatchBase MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，提供对 WatchBase Data Feed API 的访问，用于查询手表元数据。该服务允许开发者将详细的手表数据集成到他们的应用程序中，包括品牌、系列、具体型号、参考编号、技术细节和图像等信息。
View on GitHub
Overview
基本能力
产品定位
WatchBase MCP Server 是一个专门用于查询手表元数据的服务，通过 MCP 协议提供对 WatchBase Data Feed API 的访问。
核心功能
- search: 通过品牌名称、系列名称、手表名称和参考编号（全词匹配）搜索数据库。
- search_refnr: 通过参考编号（允许部分匹配）搜索数据库。
- list_brands: 检索数据库中所有手表品牌的列表。
- list_families: 检索给定品牌 ID 的所有系列（集合）列表。
- list_watches: 检索特定品牌 ID 和可选系列 ID 的手表列表，可按更新日期过滤。
- get_watch_details: 通过 WatchBase ID 检索特定手表的完整详细信息（所有数据字段）。
适用场景
- 手表爱好者或收藏家需要查询手表详细信息。
- 电子商务平台需要集成手表数据以展示产品信息。
- 开发者需要构建与手表相关的应用程序或服务。
工具列表
- search: 通过关键词搜索手表信息。
- search_refnr: 通过参考编号搜索手表信息。
- list_brands: 列出所有手表品牌。
- list_families: 列出特定品牌的所有系列。
- list_watches: 列出特定品牌和系列的手表。
- get_watch_details: 获取手表的详细信息。
常见问题解答
- 如何获取 WatchBase API Key？ 访问 WatchBase API page 申请访问权限并获取 API Key。
- 如何配置 MCP 客户端？ 需要在 MCP 客户端配置文件中指定服务器路径和 API Key。
使用教程
使用依赖
- Node.js 和 npm: 用于安装依赖和运行服务器。
bash # 检查 Node.js 和 npm 是否已安装 node -v npm -v - WatchBase API Key: 从 WatchBase API 页面获取。
安装教程
- 克隆仓库:
bash git clone https://github.com/watchdealer-pavel/watchbase-mcp.git cd watchbase-mcp - 安装依赖:
bash npm install - 构建服务器:
bash npm run build
调试方式
- 配置环境变量:
bash export WATCHBASE_API_KEY=YOUR_WATCHBASE_API_KEY - 运行服务器:
bash node build/index.js - 测试工具:
xml <use_mcp_tool> <server_name>watchbase-mcp</server_name> <tool_name>search</tool_name> <arguments> { "q": "priors court" } </arguments> </use_mcp_tool>