Сервер WatchBase MCP

Сервер MCP (Model Context Protocol), предоставляющий доступ к API WatchBase Data Feed для запроса метаданных часов.

О API WatchBase

API WatchBase Data Feed обеспечивает структурированный доступ к полной базе данных информации о часах, включая бренды, семейства (коллекции), конкретные модели часов, номера ссылок, технические детали и изображения. Он позволяет разработчикам интегрировать подробные данные о часах в свои приложения. Более подробную информацию можно найти в документации API WatchBase .

Related MCP server: DARPEngine

Функции

Этот сервер MCP предоставляет следующие инструменты, соответствующие конечным точкам API WatchBase:

• search : поиск в базе данных по названию бренда, фамилии, названию часов и номеру модели (соответствует целым словам).

• search_refnr : Поиск в базе данных по номеру ссылки (допускаются частичные совпадения).

• list_brands : Получить список всех марок часов в базе данных.

• list_families : получение списка всех семейств (коллекций) для заданного идентификатора бренда.

• list_watches : Получить список часов для определенного идентификатора бренда и, при необходимости, идентификатора семьи. Можно отфильтровать по дате обновления.

• get_watch_details : получение полной информации (всех полей данных) о конкретных часах по их идентификатору WatchBase.

Предпосылки

• Node.js и npm: требуются для установки зависимостей и запуска сервера.

• WatchBase API Key: Вам нужен API-ключ от WatchBase. Посетите страницу 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 ).

Конфигурация

Сервер требует, чтобы ваш ключ API WatchBase был предоставлен через переменную среды WATCHBASE_API_KEY . Вам необходимо настроить клиент MCP (например, Cline/Roo Code или Claude Desktop App) для запуска этого сервера и передачи переменной среды.

Пример конфигурации:

Ниже приведены примеры для распространенных клиентов MCP. Не забудьте заменить /path/to/your/watchbase-mcp/build/index.js на фактический абсолютный путь к скомпилированному файлу сервера в вашей системе, а YOUR_WATCHBASE_API_KEY на ваш настоящий ключ API WatchBase.

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 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"], // <-- 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 .

Пример 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.