WatchBase MCP 服务器

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

关于 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桌面应用程序）来运行此服务器并传递环境变量。

示例配置：

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

Cline / Roo Code (VS Code 扩展)

[此处内容根据实际使用情况继续翻译]

1. 打开 VS Code 中针对 MCP 服务器的设置。在 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 桌面应用程序

1. 打开 Claude 桌面应用程序的配置文件。在 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 使用的服务条款。