WatchBase MCP Server

WatchBase MCP服务器

](https://nodejs.org) 

MCP（模型上下文协议）服务器，提供对 WatchBase数据馈送API 用于查询全面的手表元数据。

什么是WatchBase？

WatchBase 的 是一个全面的手表数据库，包含有关豪华手表的详细信息，包括：

• 280+品牌 （劳力士、百达翡丽、爱彼等）
• 数千个手表家族/系列
• 技术规格 （病例大小、移动、并发症等）
• 参考编号 用于精确识别

特性

此MCP服务器提供了6个用于查询WatchBase API的工具：

先决条件

• Node.js 18+ （包括Node.js 25）
• WatchBase API密钥 — 在此处请求访问权限

快速开始

1.克隆和安装

git clone https://github.com/watchdealer-pavel/watchbase-mcp-server.git
cd watchbase-mcp-server
npm install

2.配置您的MCP客户端

添加到MCP客户端配置中：

克劳德桌面版 (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "watchbase": {
      "command": "node",
      "args": ["/path/to/watchbase-mcp-server/build/index.js"],
      "env": {
        "WATCHBASE_API_KEY": "your-api-key-here"
      }
    }
  }
}

克劳德代码 (.mcp.json 在您的项目中）：

{
  "mcpServers": {
    "watchbase": {
      "command": "node",
      "args": ["/path/to/watchbase-mcp-server/build/index.js"],
      "env": {
        "WATCHBASE_API_KEY": "your-api-key-here"
      }
    }
  }
}

3.重新启动MCP客户端

重新启动Claude Desktop或Claude Code以加载新的MCP服务器。

使用示例

搜索手表

Search for "Royal Oak" watches
→ Uses: search tool with q="Royal Oak"

按参考号搜索

Find watches with reference number starting with "15500"
→ Uses: search_refnr tool with q="15500"

浏览品牌和家族

List all Rolex families
→ Uses: list_brands to find Rolex ID, then list_families with brand_id

获取手表规格

Get full details for watch ID 12345
→ Uses: get_watch_details tool with id=12345

API响应示例

品牌对象

{
  "id": 59,
  "name": "Audemars Piguet"
}

观察列表响应

{
  "id": 11702,
  "refnr": "15500ST.OO.1220ST.01",
  "name": "Royal Oak",
  "brand": { "id": 59, "name": "Audemars Piguet" },
  "family": { "id": 234, "name": "Royal Oak" },
  "thumb": "https://cdn.watchbase.com/watch/medium/...",
  "updated": "2024-01-15"
}

观看详细信息响应

包括所有字段以及：

• caliber --运动细节
• case --外壳规格
• dial --拨号信息
• added, modified, published --元数据日期

手表经销商

此MCP服务器非常适合：

1. 库存管理 --查找参考号和规格
2. 价格研究 --获取详细规格以与市场价格进行比较
3. 认证 --验证参考号和规格
4. 内容创建 --生成准确的手表描述
5. 客户服务 --快速回答有关任何手表的问题

典型工作流程

1. 按参考号搜索 — search_refnr 部分参考
2. 获取手表ID 从搜索结果
3. 获取完整详细信息 — get_watch_details 带ID
4. 使用规范 用于列表、比较或研究

大型库存的增量同步

使用 list_watches 和 updated_since 仅同步已更改记录的参数：

list_watches with brand_id=59, updated_since="2024-01-01"
→ Returns only watches updated after Jan 1, 2024

API 文档

看 watchbase_api_reference.md API的详细文档。

发展

# Watch mode (auto-rebuild on changes)
npm run dev

# Manual build
npm run build

# Run the server directly
npm start

故障排除

“WATCHBASE_API_KEY环境变量是必需的”

确保您已添加 WATCHBASE_API_KEY 发送给您的MCP客户 env 配置。

“WatchBase API错误：无效或未经授权的API密钥”

您的API密钥可能无效或已过期。联系WatchBase支持人员。

服务器未出现在Claude中

1. 检查路径 build/index.js 是正确的
2. 重新启动克劳德桌面/代码
3. 检查日志中的连接错误

许可证

MIT许可证——见 许可证 文件。

注： 此MCP服务器是一个独立的项目。请参考 WatchBase服务条款 API使用策略。

链接

• WatchBase数据馈送 -API访问和定价
• WatchBase网站 --浏览手表数据库
• 模型上下文协议 --MCP文件