WatchBase MCP Server

WatchBase MCP 서버

WatchBase Data Feed API에 대한 액세스를 제공하여 시계 메타데이터를 쿼리할 수 있는 MCP(Model Context Protocol) 서버입니다.

WatchBase API에 대하여

WatchBase 데이터 피드 API는 브랜드, 제품군(컬렉션), 특정 시계 모델, 참조 번호, 기술 세부 정보, 이미지 등 포괄적인 시계 정보 데이터베이스에 대한 체계적인 액세스를 제공합니다. 개발자는 이를 통해 상세한 시계 데이터를 애플리케이션에 통합할 수 있습니다. 자세한 내용은 WatchBase API 문서 에서 확인할 수 있습니다.

특징

이 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. 저장소를 복제합니다.지엑스피1
2. 종속성 설치:
   npm install
3. 서버를 빌드하세요:
   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 시스템에서 컴파일된 서버 파일의 실제 절대 경로로 바꾸고, YOUR_WATCHBASE_API_KEY 실제 WatchBase API 키로 바꾸세요.

클라인/루 코드(VS 코드 확장)

1. MCP 서버용 VS Code 설정을 엽니다. macOS에서는 일반적으로 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json 에 있습니다 . (참고: 정확한 경로는 운영 체제 및 VS Code 설치 유형에 따라 다를 수 있습니다. Roo Code의 경우 saoudrizwan.claude-dev rooveterinaryinc.roo-cline 으로 변경하세요.)
2. 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 }

클로드 데스크톱 앱

1. Claude Desktop App 구성 파일을 엽니다. macOS에서는 일반적으로 ~/Library/Application Support/Claude/claude_desktop_config.json 에 있습니다 . (참고: 정확한 경로는 운영 체제에 따라 다를 수 있습니다.)
2. 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 예시

search_refnr 번호 예시

list_brands 예시

list_families 예제

list_watches 예제

get_watch_details 예제

특허

이 MCP 서버 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.

API 사용과 관련하여 WatchBase 서비스 약관도 참조하세요.