Servidor MCP de WatchBase

Un servidor MCP (Protocolo de contexto de modelo) que proporciona acceso a la API de fuente de datos de WatchBase para consultar metadatos de vigilancia.

Acerca de la API de WatchBase

La API de fuente de datos de WatchBase proporciona acceso estructurado a una base de datos completa con información sobre relojes, incluyendo marcas, familias (colecciones), modelos específicos, números de referencia, detalles técnicos e imágenes. Permite a los desarrolladores integrar datos detallados de relojes en sus aplicaciones. Puede encontrar más información en la documentación de la API de WatchBase .

Related MCP server: DARPEngine

Características

Este servidor MCP expone las siguientes herramientas correspondientes a los puntos finales de la API de WatchBase:

• search : busque en la base de datos por nombre de marca, apellido, nombre de reloj y número de referencia (coincide con palabras completas).

• search_refnr : busca en la base de datos por número de referencia (permite coincidencias parciales).

• list_brands : recupera una lista de todas las marcas de relojes en la base de datos.

• list_families : recupera una lista de todas las familias (colecciones) para una ID de marca determinada.

• list_watches : Recupera una lista de relojes para un ID de marca específico y, opcionalmente, un ID de familia. Se puede filtrar por fecha de actualización.

• get_watch_details : recupera los detalles completos (todos los campos de datos) de un reloj en particular mediante su ID WatchBase.

Prerrequisitos

• Node.js y npm: necesarios para instalar dependencias y ejecutar el servidor.

• Clave API de WatchBase: Necesita una clave API de WatchBase. Visite la página de la API de WatchBase para solicitar acceso y obtener una clave.

Instalación

1. Clonar el repositorio:

   git clone https://github.com/watchdealer-pavel/watchbase-mcp.git cd watchbase-mcp

2. Instalar dependencias:

   npm install

3. Construir el servidor:

   npm run build

   Este comando compila el código fuente de TypeScript en JavaScript, colocando la salida en el directorio build/ (específicamente build/index.js ).

Configuración

El servidor requiere que proporciones tu clave API de WatchBase mediante la variable de entorno WATCHBASE_API_KEY . Debes configurar tu cliente MCP (como Cline/Roo Code o la aplicación de escritorio Claude) para ejecutar este servidor y pasar la variable de entorno.

Ejemplo de configuración:

A continuación se muestran ejemplos de clientes MCP comunes. Recuerde reemplazar

Código Cline/Roo (Extensión VS Code)

1. Abra la configuración de VS Code para servidores MCP. En macOS, normalmente se encuentra en: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json(Nota: La ruta exacta puede variar según el sistema operativo y el tipo de instalación de VS Code. Para Roo Code, reemplace

2. Agregue el siguiente bloque de configuración bajo la clave 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 }

Aplicación de escritorio Claude

1. Abra el archivo de configuración de la aplicación Claude Desktop. En macOS, suele estar en: ~/Library/Application Support/Claude/claude_desktop_config.json(Nota: La ruta exacta puede variar según el sistema operativo).

2. Agregue el siguiente bloque de configuración bajo la clave 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 }

Uso

Una vez configurado, puedes invocar las herramientas del servidor desde tu asistente de IA usando el comando/herramienta use_mcp_tool .

Ejemplo search

Ejemplo search_refnr

Ejemplo list_brands

Ejemplo list_families

Ejemplo list_watches

Ejemplo get_watch_details

Licencia

Este proyecto de servidor MCP tiene licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Consulte también los términos de servicio de WatchBase con respecto al uso de la API.