WatchBase MCP 服务器

一个 MCP (模型上下文协议) 服务器，提供对 WatchBase 数据馈送 API 的访问，用于查询手表元数据。

关于 WatchBase API

WatchBase 数据馈送 API 提供对手表信息的综合数据库的结构化访问，包括品牌、系列（集合）、特定手表型号、参考编号、技术细节和图像。它允许开发人员将详细的手表数据集成到他们的应用程序中。更多信息请访问 WatchBase API 文档。

功能

此 MCP 服务器公开了与 WatchBase API 端点相对应的以下工具：

• search: 按品牌名称、系列名称、手表名称和参考编号搜索数据库（匹配整个单词）。
• search_refnr: 按参考编号搜索数据库（允许部分匹配）。
• list_brands: 检索数据库中所有手表品牌的列表。
• list_families: 检索给定品牌 ID 的所有系列（集合）的列表。
• list_watches: 检索特定品牌 ID 的手表列表，并可选择系列 ID。可以按更新日期进行过滤。
• get_watch_details: 按 WatchBase ID 检索特定手表的完整详细信息（所有数据字段）。

前提条件

• Node.js 和 npm: 需要安装依赖项并运行服务器。
• WatchBase API 密钥: 您需要从 WatchBase 获取 API 密钥。访问 WatchBase API 页面 以请求访问并获取密钥。

安装

1. 克隆存储库:

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

2. 安装依赖项:

   npm install
   

3. 构建服务器:

   npm run build
   

   此命令将 TypeScript 源代码编译为 JavaScript，并将输出放置在 build/ 目录中（特别是 build/index.js）。

配置

服务器需要通过 WATCHBASE_API_KEY 环境变量提供您的 WatchBase API 密钥。您需要配置您的 MCP 客户端（如 Cline/Roo Code 或 Claude Desktop App）来运行此服务器并传递环境变量。

配置示例:

以下是常见 MCP 客户端的示例。请记住将 /path/to/your/watchbase-mcp/build/index.js 替换为您系统上已编译服务器文件的实际绝对路径，并将 YOUR_WATCHBASE_API_KEY 替换为您的真实 WatchBase API 密钥。

Cline / Roo Code (VS Code 扩展)

1. 打开 MCP 服务器的 VS Code 设置。在 macOS 上，这通常位于： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (注意：确切路径可能因您的操作系统和 VS Code 安装类型而异。对于 Roo Code，请将 saoudrizwan.claude-dev 替换为 rooveterinaryinc.roo-cline)

2. 在 mcpServers 键下添加以下配置块：

   "watchbase-mcp": {
     "command": "node",
     "args": ["/path/to/your/watchbase-mcp/build/index.js"], // <-- 重要提示：替换为 build/index.js 的实际绝对路径
     "env": {
       "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- 重要提示：替换为您的 WatchBase API 密钥
     },
     "disabled": false,
     "autoApprove": [] // 或者添加您想要自动批准的特定工具
   }
   

Claude Desktop App

1. 打开 Claude Desktop App 配置文件。在 macOS 上，这通常位于： ~/Library/Application Support/Claude/claude_desktop_config.json (注意：确切路径可能因您的操作系统而异。)

2. 在 mcpServers 键下添加以下配置块：

   "watchbase-mcp": {
     "command": "node",
     "args": ["/path/to/your/watchbase-mcp/build/index.js"], // <-- 重要提示：替换为 build/index.js 的实际绝对路径
     "env": {
       "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- 重要提示：替换为您的 WatchBase API 密钥
     },
     "disabled": false,
     "autoApprove": [] // 或者添加您想要自动批准的特定工具
   }
   

用法

配置完成后，您可以使用 use_mcp_tool 命令/工具从您的 AI 助手调用服务器的工具。

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>

许可证

此 MCP 服务器项目已获得 MIT 许可证的许可 - 有关详细信息，请参阅 LICENSE 文件。

另请参阅 WatchBase 关于 API 使用的服务条款。