WatchBase MCP Server

WatchBase MCP 服务

一个 MCP（Model Context Protocol）服务，可访问 WatchBase Data Feed API，查询全面的腕表元数据。

什么是 WatchBase？

WatchBase 是一个全面的腕表数据库，包含奢华腕表的详细信息，包括：

• 280 多个品牌（Rolex、Patek Philippe、Audemars Piguet 等）
• 数千个腕表系列／集合
• 技术规格（表壳尺寸、机芯、复杂功能等）
• 用于精确识别的型号编号

功能

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

工具	描述	必填参数
search	按品牌、系列、腕表名称或型号编号搜索（完整词语）	q
search_refnr	按型号编号搜索（允许部分匹配）	q
list_brands	获取数据库中的所有腕表品牌	—
list_families	获取某个品牌的所有系列／集合	brand_id
list_watches	获取某个品牌／系列的腕表（可选日期筛选）	brand_id
get_watch_details	获取特定腕表的完整规格	id

先决条件

• Node.js 18+（包括 Node.js 25）
• WatchBase API Key — 在此申请访问权限

快速开始

1. 克隆并安装

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

2. 配置 MCP 客户端

将以下内容添加到 MCP 客户端配置中：

Claude Desktop（~/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"
      }
    }
  }
}

Claude Code（项目中的 .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. 使用规格进行商品发布、比较或调研

大型库存的增量同步

使用带有 updated_since 参数的 list_watches，仅同步有变更的记录：

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

API 文档

详细 API 文档请参见 watchbase_api_reference.md。

开发

# 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 key 无效或未获授权”

你的 API key 可能无效或已过期。请联系 WatchBase 支持。

Claude 中未显示服务

1. 检查 build/index.js 的路径是否正确
2. 重启 Claude Desktop／Code
3. 检查日志中是否有连接错误

许可证

MIT License — 参见 LICENSE 文件。

**注意：**此 MCP 服务是一个独立项目。有关 API 使用政策，请参阅 WatchBase Terms of Service。

链接

• WatchBase Data Feed — API 访问权限和定价
• WatchBase Website — 浏览手表数据库
• Model Context Protocol — MCP 文档