Choavis MCP

Choavis MCP (Model Context Protocol) 서버는 Claude가 무신사(Musinsa)에서 패션 상품을 검색할 수 있게 해주는 도구입니다. 사용자의 자연어 요청을 분석하여 적절한 키워드로 변환하고, 무신사 API를 통해 상품을 검색하여 구매 링크와 함께 결과를 제공합니다.

특징

• 🔍 자연어 검색: "지금 너무 더운데 시원하게 입을 반바지 추천해줘" 같은 자연어 요청 처리
• 🎯 스마트 키워드 추출: Claude가 자연어를 무신사 검색에 최적화된 키워드로 변환
• 🛒 직접 구매 링크: 각 상품마다 무신사 구매 페이지로 바로 이동하는 링크 제공
• 📊 상세 정보: 가격, 할인율, 평점, 리뷰 수, 브랜드 정보 포함
• ⚡ 빠른 검색: 무신사 공식 API를 통한 실시간 상품 정보
• 💬 리뷰 조회: 상품별 리뷰와 평점 분포, 사용자 후기 확인 가능

Claude Desktop 설정

1. 설정 파일 위치

Claude Desktop 설정 파일을 열어주세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json

2. MCP 서버 등록 (npx 사용 - 권장)

{
  "mcpServers": {
    "musinsa-mcp": {
      "command": "npx",
      "args": ["-y", "musinsa-mcp", "--stdio"]
    }
  }
}

3. 대안: 글로벌 설치 후 사용

npm install -g musinsa-mcp

{
  "mcpServers": {
    "musinsa-mcp": {
      "command": "musinsa-mcp",
      "args": ["--stdio"]
    }
  }
}

4. 개발자용: 로컬 설치

git clone https://github.com/choavis/choavis-mcp.git
cd choavis-mcp
npm install
npm run build

{
  "mcpServers": {
    "musinsa-mcp": {
      "command": "node",
      "args": ["/절대경로/choavis-mcp/dist/index.js", "--stdio"],
      "cwd": "/절대경로/choavis-mcp"
    }
  }
}

5. Claude Desktop 재시작

설정 완료 후 Claude Desktop을 완전히 종료하고 다시 실행해주세요.

사용 방법

Claude Desktop에서 다음과 같은 요청을 할 수 있습니다:

기본 사용 예시

"나이키 운동화 추천해줘"
"지금 너무 더운데 시원한 반바지 찾아줘"
"정장에 어울리는 구두 보여줘"
"데이트에 입을 예쁜 원피스 추천"
"겨울 패딩 검색해줘"

고급 검색

• 성별 필터: "남성용 셔츠", "여성용 가방"
• 브랜드 지정: "아디다스 신발", "나이키 후드티"
• 가격 정렬: "저렴한 바지", "프리미엄 코트"

리뷰 조회

상품 검색 후 goodsNo(상품번호)를 사용하여 리뷰를 조회할 수 있습니다:

"4989763번 상품의 리뷰를 보여줘"
"이 상품의 평점 분포를 알려줘"
"사진 리뷰만 보고 싶어"
"평점 높은 리뷰부터 보여줘"

리뷰 정보에는 다음이 포함됩니다:

• ⭐ 평균 평점과 평점 분포
• 📝 리뷰 내용과 작성자 정보 (신체 정보 포함)
• 📷 리뷰 사진
• 👍 도움된 수
• 📅 작성일

기술 스택

• Node.js - 런타임 환경
• TypeScript - 타입 안전성
• MCP SDK - Claude와의 통신
• Musinsa API - 상품 검색

개발

개발 환경 설정

git clone https://github.com/choavis/choavis-mcp.git
cd choavis-mcp
npm install

개발 모드 실행

npm run dev

빌드

npm run build

테스트

npm start

문제 해결

일반적인 문제

1. "musinsa-mcp 명령을 찾을 수 없음"

   • npm install -g musinsa-mcp 재실행
   • npm list -g musinsa-mcp로 설치 확인

2. Claude Desktop에서 도구가 보이지 않음

   • 설정 파일 경로 확인
   • JSON 문법 오류 확인
   • Claude Desktop 재시작

3. 검색 결과가 나오지 않음

   • 인터넷 연결 확인
   • 키워드를 더 간단하게 변경

로그 확인

개발 모드에서 자세한 로그를 확인할 수 있습니다:

node dist/index.js

라이선스

MIT License

기여

이슈나 풀 리퀘스트는 언제든 환영합니다!

지원

문제가 발생하면 GitHub Issues에 문의해주세요.