WatchBase MCP 서버
WatchBase Data Feed API에 대한 액세스를 제공하여 시계 메타데이터를 쿼리할 수 있는 MCP(Model Context Protocol) 서버입니다.
WatchBase API에 대하여
WatchBase 데이터 피드 API는 브랜드, 제품군(컬렉션), 특정 시계 모델, 참조 번호, 기술 세부 정보, 이미지 등 포괄적인 시계 정보 데이터베이스에 대한 체계적인 액세스를 제공합니다. 개발자는 이를 통해 상세한 시계 데이터를 애플리케이션에 통합할 수 있습니다. 자세한 내용은 WatchBase API 문서 에서 확인할 수 있습니다.
Related MCP server: DARPEngine
특징
이 MCP 서버는 WatchBase API 엔드포인트에 해당하는 다음 도구를 제공합니다.
search: 브랜드 이름, 제품군 이름, 시계 이름, 참조 번호(전체 단어와 일치)로 데이터베이스를 검색합니다.search_refnr: 참조 번호로 데이터베이스를 검색합니다(부분 일치 허용).list_brands: 데이터베이스에 있는 모든 시계 브랜드 목록을 검색합니다.list_families: 주어진 브랜드 ID에 대한 모든 제품군(컬렉션) 목록을 검색합니다.list_watches: 특정 브랜드 ID 및 선택적으로 제품군 ID에 해당하는 시계 목록을 가져옵니다. 업데이트 날짜별로 필터링할 수 있습니다.get_watch_details: WatchBase ID를 사용하여 특정 시계의 전체 세부 정보(모든 데이터 필드)를 검색합니다.
필수 조건
Node.js 및 npm: 종속성을 설치하고 서버를 실행하는 데 필요합니다.
WatchBase API 키: WatchBase의 API 키가 필요합니다. WatchBase API 페이지를 방문하여 액세스를 요청하고 키를 받으세요.
설치
저장소를 복제합니다.
지엑스피1
종속성 설치:
npm install서버를 빌드하세요:
npm run build이 명령은 TypeScript 소스 코드를 JavaScript로 컴파일하고 출력을
build/디렉토리(특히build/index.js)에 저장합니다.
구성
서버를 사용하려면 WATCHBASE_API_KEY 환경 변수를 통해 WatchBase API 키를 제공해야 합니다. MCP 클라이언트(예: Cline/Roo Code 또는 Claude Desktop App)에서 이 서버를 실행하고 환경 변수를 전달하도록 구성해야 합니다.
구성 예:
다음은 일반적인 MCP 클라이언트의 예입니다. /path/to/your/watchbase-mcp/build/index.js
클라인/루 코드(VS 코드 확장)
MCP 서버용 VS Code 설정을 엽니다. macOS에서는 일반적으로
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json에 있습니다 . (참고: 정확한 경로는 운영 체제 및 VS Code 설치 유형에 따라 다를 수 있습니다. Roo Code의 경우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 }
클로드 데스크톱 앱
Claude Desktop App 구성 파일을 엽니다. macOS에서는 일반적으로
~/Library/Application Support/Claude/claude_desktop_config.json에 있습니다 . (참고: 정확한 경로는 운영 체제에 따라 다를 수 있습니다.)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 명령/도구를 사용하여 AI 어시스턴트에서 서버 도구를 호출할 수 있습니다.
search 예시
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>search</tool_name>
<arguments>
{
"q": "priors court"
}
</arguments>
</use_mcp_tool>search_refnr 번호 예시
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>search_refnr</tool_name>
<arguments>
{
"q": "P2/"
}
</arguments>
</use_mcp_tool>list_brands 예시
<use_mcp_tool>
<server_name>watchbase-mcp</server_name>
<tool_name>list_brands</tool_name>
<arguments>
{}
</arguments>
</use_mcp_tool>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>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>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>특허
이 MCP 서버 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.
API 사용과 관련하여 WatchBase 서비스 약관도 참조하세요.