WatchBase MCP Server

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

示例配置：

以下是常见 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"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- IMPORTANT: Replace with your WatchBase API Key }, "disabled": false, "autoApprove": [] // Or add specific tools you want to auto-approve }

克劳德桌面应用程序

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"], // <-- IMPORTANT: Replace with the ACTUAL absolute path to build/index.js "env": { "WATCHBASE_API_KEY": "YOUR_WATCHBASE_API_KEY" // <-- IMPORTANT: Replace with your WatchBase API Key }, "disabled": false, "autoApprove": [] // Or add specific tools you want to auto-approve }

用法

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

search示例

search_refnr示例

list_brands示例

list_families示例

list_watches示例

get_watch_details示例

执照

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

有关 API 使用情况，另请参阅 WatchBase 服务条款。