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: mcp-mediawiki-crunchtools

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 /path/to/your/watchbase-mcp/build/index.js con la ruta absoluta del archivo de servidor compilado en su sistema y YOUR_WATCHBASE_API_KEY con su clave API de WatchBase.

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 saoudrizwan.claude-dev por rooveterinaryinc.roo-cline ).

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

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search</tool_name>
  <arguments>
    {
      "q": "priors court"
    }
  </arguments>
</use_mcp_tool>

Ejemplo search_refnr

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>search_refnr</tool_name>
  <arguments>
    {
      "q": "P2/"
    }
  </arguments>
</use_mcp_tool>

Ejemplo list_brands

<use_mcp_tool>
  <server_name>watchbase-mcp</server_name>
  <tool_name>list_brands</tool_name>
  <arguments>
    {}
  </arguments>
</use_mcp_tool>

Ejemplo 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>

Ejemplo 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>

Ejemplo 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>

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.