Сервер 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. Не забудьте заменить

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 замените

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

Пример search_refnr

Пример list_brands

Пример list_families

Пример list_watches

Пример get_watch_details

Лицензия

Данный проект сервера MCP лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Пожалуйста, также ознакомьтесь с условиями обслуживания WatchBase относительно использования API.