基本能力
产品定位
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>