watchdealer pavel watchbase mcp server
by watchdealer-pavel
MCP Server for structured and standardized querying of watch-related metadata such as brands, families, and reference details from WatchBase.com.
What is watchdealer pavel watchbase mcp server
WatchBase MCP Server
An MCP (Model Context Protocol) server providing access to the WatchBase Data Feed API for querying watch metadata.
About WatchBase API
The WatchBase Data Feed API provides structured access to a comprehensive database of watch information, including brands, families (collections), specific watch models, reference numbers, technical details, and images. It allows developers to integrate detailed watch data into their applications. More information can be found on the WatchBase API Documentation.
Features
This MCP server exposes the following tools corresponding to the WatchBase API endpoints:
search
: Search the database by brand name, family name, watch name, and reference number (matches whole words).search_refnr
: Search the database by reference number (allows partial matches).list_brands
: Retrieve a list of all watch brands in the database.list_families
: Retrieve a list of all families (collections) for a given brand ID.list_watches
: Retrieve a list of watches for a particular Brand ID and optionally Family ID. Can be filtered by update date.get_watch_details
: Retrieve the full details (all data fields) for a particular watch by its WatchBase ID.
Prerequisites
- Node.js and npm: Required to install dependencies and run the server.
- WatchBase API Key: You need an API key from WatchBase. Visit the WatchBase API page to request access and obtain a key.
Installation
-
Clone the repository:
git clone https://github.com/watchdealer-pavel/watchbase-mcp.git cd watchbase-mcp
-
Install dependencies:
npm install
-
Build the server:
npm run build
This command compiles the TypeScript source code into JavaScript, placing the output in the
build/
directory (specificallybuild/index.js
).
Configuration
The server requires your WatchBase API key to be provided via the WATCHBASE_API_KEY
environment variable. You need to configure your MCP client (like Cline/Roo Code or the Claude Desktop App) to run this server and pass the environment variable.
Example Configuration:
Below are examples for common MCP clients. Remember to replace /path/to/your/watchbase-mcp/build/index.js
with the actual absolute path to the compiled server file on your system, and YOUR_WATCHBASE_API_KEY
with your real WatchBase API key.
Cline / Roo Code (VS Code Extension)
-
Open your VS Code settings for MCP servers. On macOS, this is typically located at:
~/Library/Application Support/claude-code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
(Note: The exact path might vary based on your operating system and VS Code installation type. For Roo Code, replacesaoudrizwan.claude-dev
withrooveterinaryinc.roo-cline
) -
Add the following configuration block under the
mcpServers
key:"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
-
Open the Claude Desktop App configuration file. On macOS, this is typically located at:
~/Library/Application Support/Claude/claude_desktop_config.json
(Note: The exact path might vary based on your operating system.) -
Add the following configuration block under the
mcpServers
key:"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 }
Usage
Once configured, you can invoke the server's tools from your AI assistant using the use_mcp_tool
command/tool.
search
Example
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>search</tool_name>
<arguments>
{
"q": "priors court"
}
</arguments>
</use_mcp_tool>
search_refnr
Example
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>search_refnr</tool_name>
<arguments>
{
"q": "P2/"
}
</arguments>
</use_mcp_tool>
list_brands
Example
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>list_brands</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>
list_families
Example
<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
Example
<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
Example
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>get_watch_details</tool_name>
<arguments>
{
"id": 17289
}
</arguments>
</use_mcp_tool>
License
This MCP server project is licensed under the MIT License - see the LICENSE file for details.
Please also refer to WatchBase terms of service regarding API usage.
Leave a Comment
Frequently Asked Questions
What is MCP?
MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to LLMs. Think of MCP like a USB-C port for AI applications, providing a standardized way to connect AI models to different data sources and tools.
What are MCP Servers?
MCP Servers are lightweight programs that expose specific capabilities through the standardized Model Context Protocol. They act as bridges between LLMs like Claude and various data sources or services, allowing secure access to files, databases, APIs, and other resources.
How do MCP Servers work?
MCP Servers follow a client-server architecture where a host application (like Claude Desktop) connects to multiple servers. Each server provides specific functionality through standardized endpoints and protocols, enabling Claude to access data and perform actions through the standardized protocol.
Are MCP Servers secure?
Yes, MCP Servers are designed with security in mind. They run locally with explicit configuration and permissions, require user approval for actions, and include built-in security features to prevent unauthorized access and ensure data privacy.
Related MCP Servers
chrisdoc hevy mcp
sylphlab pdf reader mcp
An MCP server built with Node.js/TypeScript that allows AI agents to securely read PDF files (local or URL) and extract text, metadata, or page counts. Uses pdf-parse.
aashari mcp server atlassian bitbucket
Node.js/TypeScript MCP server for Atlassian Bitbucket. Enables AI systems (LLMs) to interact with workspaces, repositories, and pull requests via tools (list, get, comment, search). Connects AI directly to version control workflows through the standard MCP interface.
aashari mcp server atlassian confluence
Node.js/TypeScript MCP server for Atlassian Confluence. Provides tools enabling AI systems (LLMs) to list/get spaces & pages (content formatted as Markdown) and search via CQL. Connects AI seamlessly to Confluence knowledge bases using the standard MCP interface.
prisma prisma
Next-generation ORM for Node.js & TypeScript | PostgreSQL, MySQL, MariaDB, SQL Server, SQLite, MongoDB and CockroachDB
Zzzccs123 mcp sentry
mcp sentry for typescript sdk
zhuzhoulin dify mcp server
zhongmingyuan mcp my mac
zhixiaoqiang desktop image manager mcp
MCP 服务器,用于管理桌面图片、查看详情、压缩、移动等(完全让Trae实现)
zhixiaoqiang antd components mcp
An MCP service for Ant Design components query | 一个减少 Ant Design 组件代码生成幻觉的 MCP 服务,包含系统提示词、组件文档、API 文档、代码示例和更新日志查询
Submit Your MCP Server
Share your MCP server with the community
Submit Now