WatchBase MCP-Server

Ein MCP-Server (Model Context Protocol), der Zugriff auf die WatchBase Data Feed API zum Abfragen von Watch-Metadaten bietet.

Über die WatchBase-API

Die WatchBase Data Feed API bietet strukturierten Zugriff auf eine umfassende Datenbank mit Uhreninformationen, darunter Marken, Familien (Kollektionen), spezifische Uhrenmodelle, Referenznummern, technische Details und Bilder. Entwickler können damit detaillierte Uhrendaten in ihre Anwendungen integrieren. Weitere Informationen finden Sie in der WatchBase API-Dokumentation .

Related MCP server: DARPEngine

Merkmale

Dieser MCP-Server stellt die folgenden Tools bereit, die den WatchBase-API-Endpunkten entsprechen:

• search : Durchsuchen Sie die Datenbank nach Markennamen, Familiennamen, Uhrennamen und Referenznummer (entspricht ganzen Wörtern).

• search_refnr : Durchsucht die Datenbank nach Referenznummer (erlaubt teilweise Übereinstimmungen).

• list_brands : Ruft eine Liste aller Uhrenmarken in der Datenbank ab.

• list_families : Ruft eine Liste aller Familien (Sammlungen) für eine bestimmte Marken-ID ab.

• list_watches : Ruft eine Liste von Uhren für eine bestimmte Marken-ID und optional eine Familien-ID ab. Kann nach Aktualisierungsdatum gefiltert werden.

• get_watch_details : Ruft die vollständigen Details (alle Datenfelder) für eine bestimmte Uhr anhand ihrer WatchBase-ID ab.

Voraussetzungen

• Node.js und npm: Erforderlich, um Abhängigkeiten zu installieren und den Server auszuführen.

• WatchBase API-Schlüssel: Sie benötigen einen API-Schlüssel von WatchBase. Besuchen Sie die WatchBase API-Seite, um Zugriff anzufordern und einen Schlüssel zu erhalten.

Installation

1. Klonen Sie das Repository:

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

2. Installieren Sie Abhängigkeiten:

   npm install

3. Erstellen Sie den Server:

   npm run build

   Dieser Befehl kompiliert den TypeScript-Quellcode in JavaScript und platziert die Ausgabe im Verzeichnis build/ (insbesondere build/index.js ).

Konfiguration

Der Server benötigt Ihren WatchBase-API-Schlüssel über die Umgebungsvariable WATCHBASE_API_KEY . Sie müssen Ihren MCP-Client (z. B. Cline/Roo Code oder die Claude Desktop App) so konfigurieren, dass dieser Server ausgeführt wird und die Umgebungsvariable übergeben wird.

Beispielkonfiguration:

Nachfolgend finden Sie Beispiele für gängige MCP-Clients. Denken Sie daran,

Cline / Roo Code (VS Code-Erweiterung)

1. Öffnen Sie Ihre VS Code-Einstellungen für MCP-Server. Unter macOS befindet sich dieser typischerweise unter: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json(Hinweis: Der genaue Pfad kann je nach Betriebssystem und VS Code-Installationstyp variieren. Für Roo Code ersetzen Sie

2. Fügen Sie den folgenden Konfigurationsblock unter dem Schlüssel mcpServers hinzu:

   "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 }

Claude Desktop App

1. Öffnen Sie die Konfigurationsdatei der Claude Desktop App. Unter macOS befindet sie sich normalerweise unter: ~/Library/Application Support/Claude/claude_desktop_config.json(Hinweis: Der genaue Pfad kann je nach Betriebssystem variieren.)

2. Fügen Sie den folgenden Konfigurationsblock unter dem Schlüssel mcpServers hinzu:

   "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 }

Verwendung

Nach der Konfiguration können Sie die Tools des Servers von Ihrem KI-Assistenten aus mit dem Befehl/Tool use_mcp_tool aufrufen.

search Beispiel

search_refnr Beispiel

list_brands Beispiel

list_families Beispiel

list_watches Beispiel

get_watch_details Beispiel

Lizenz

Dieses MCP-Serverprojekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Bitte beachten Sie auch die Servicebedingungen von WatchBase bezüglich der API-Nutzung.