WatchBase MCP Server

🚀 WatchBase MCP 服务器

该 MCP（模型上下文协议）服务器可提供对 WatchBase 数据 feed API 的访问权限，主要用于查询手表元数据。

🚀 快速开始

WatchBase MCP 服务器能让你便捷地访问 WatchBase 数据 feed API，从而查询手表元数据。在使用前，请确保满足先决条件，并完成安装与配置。

✨ 主要特性

此 MCP 服务器具备以下实用功能：

1. 搜索：依据查询字符串搜索手表。
2. 按参考编号搜索：根据部分参考编号搜索手表（支持通配符）。
3. 列出品牌：获取所有可用品牌的列表。
4. 列出系列：根据指定的品牌 ID 获取该品牌的系列列表。
5. 列出手表：根据品牌 ID 和可选的系列 ID 获取特定品牌和/或系列下的手表列表。
6. 获取手表详细信息：通过指定的手表 ID 获取其详细信息。

📦 安装指南

先决条件

• 安装 Node.js 和 npm
• 获取 WatchBase API 访问密钥

安装步骤

1. 从 GitHub 克隆仓库：

git clone https://github.com/your-repository.git

2. 在项目目录中安装依赖项：

npm install

3. 使用以下命令构建服务器：

npm run build

📚 详细文档

关于 WatchBase API

WatchBase 数据 feed API 提供了对全面的手表信息数据库的结构化访问，涵盖品牌、系列（收藏）、特定型号、参考编号、技术细节和图像等内容。它允许开发人员将其详细的手表数据集成到应用程序中。更多相关信息请参阅 WatchBase API 文档。

配置

将 API_KEY 环境变量设置为您的 WatchBase API 访问密钥。

Cline/Roo Code 配置示例

在 config.json 文件中添加以下内容：

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

Claude Desktop App 配置示例

在 config.json 文件中添加以下内容：

{
  "servers": {
    "watchbase-mcp": {
      "host": "localhost",
      "port": 3000,
      "api_key": "your_api_key_here"
    }
  }
}

💻 使用示例

以下是每个工具的使用示例：

基础用法

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 使用的相关规定。