FindMine 쇼핑 스타일리스트

FindMine의 강력한 제품 스타일링 및 의류 추천 기능을 Claude 및 기타 MCP 호환 애플리케이션과 통합하는 MCP(Model Context Protocol) 서버입니다.

개요

이 MCP 서버는 FindMine의 스타일링 API에 연결하고 모델 컨텍스트 프로토콜을 통해 대규모 언어 모델(Large Language Models)에 해당 기능을 제공합니다. 사용자는 다음을 수행할 수 있습니다.

제품 및 의상 정보 탐색
특정 제품에 대한 의상 추천을 받으세요
시각적으로 유사한 제품 찾기
스타일 가이드 및 패션 조언에 액세스하세요

특징

자원

제품 : product:/// URI 체계를 사용한 자세한 제품 정보
룩 : look look:/// URI 체계를 활용한 완벽한 의상 추천

도구

get_style_guide : 자세한 패션 조언과 스타일링 가이드라인을 확인하세요
get_complete_the_look : 제품에 대한 의상 추천을 받으세요
get_visually_similar : 시각적으로 유사한 제품 찾기

프롬프트

outfit_completion : 완벽한 옷차림을 위한 스타일링 조언을 받으세요
styling_guide : 포괄적인 패션 스타일링 가이드라인을 확인하세요
findmine_help : FindMine의 도구와 리소스를 사용하는 방법을 알아보세요

설치

옵션 1: npm에서 설치

지엑스피1

옵션 2: Docker로 실행

docker run -e FINDMINE_APP_ID=your_app_id findmine/mcp-server:latest

옵션 3: 소스에서 복제 및 빌드

# Clone the repository
git clone https://github.com/findmine/findmine-mcp.git
cd findmine-mcp

# Install dependencies
npm install

# Build the server
npm run build

# For development with auto-rebuild
npm run watch

구성

환경 변수

변하기 쉬운	설명	기본
`FINDMINE_API_URL`	FindMine API 기본 URL	https://api.findmine.com
`FINDMINE_APP_ID`	FindMine 애플리케이션 ID	데모 앱 ID
`FINDMINE_API_VERSION`	사용할 API 버전	v3
`FINDMINE_DEFAULT_REGION`	기본 지역 코드	우리를
`FINDMINE_DEFAULT_LANGUAGE`	기본 언어 코드	엔
`FINDMINE_CACHE_ENABLED`	응답 캐싱 활성화	진실
`FINDMINE_CACHE_TTL_MS`	캐시 수명(ms)	3600000(1시간)
`NODE_ENV`	샘플 데이터의 경우 "개발"로 설정	-

Claude Desktop과 함께 사용

서버는 설치 중에 Claude Desktop을 자동으로 구성합니다. 확인하려면 다음을 수행하세요.

맥OS:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

윈도우:

type %APPDATA%\Claude\claude_desktop_config.json

개발

MCP 검사관

MCP Inspector는 서버를 테스트하기 위한 개발 도구입니다.

npm run inspector

이렇게 하면 http://localhost:5173 에서 웹 인터페이스가 열리고 여기서 서버와 상호 작용할 수 있습니다.

개발 모드

샘플 데이터로 서버를 실행합니다.

NODE_ENV=development npm run build && node build/index.js

스타일 가이드 사용자 정의

스타일 가이드는 브랜드의 특정 스타일링 철학과 패션 트렌드에 맞춰 맞춤 설정할 수 있습니다. 스타일 가이드를 맞춤 설정하려면 다음 단계를 따르세요.

src/index.ts 에서 스타일 가이드를 찾으세요( styleGuides 검색)
각 카테고리( general , color_theory , body_types 등)의 콘텐츠를 수정합니다.
styleGuides 객체를 확장하여 새로운 카테고리를 추가합니다.
상황에 맞는 맞춤형 조언과 계절별 조언을 제공합니다.

사용자 정의 스타일 가이드 범주를 추가하는 예:

// In src/index.ts
const styleGuides: Record<string, string> = {
  // Existing categories...
  
  // Add your custom category
  your_brand_style: `# Your Brand Style Guide
  
## Brand Aesthetic
- Key elements of your brand's visual identity
- Core style principles
- Signature looks and combinations

## Your Brand's Styling Do's
- Brand-specific styling recommendations
- Preferred color combinations
- Signature styling techniques

## Your Brand's Styling Don'ts
- Combinations to avoid
- Styling approaches that don't align with brand identity
- Common styling mistakes to avoid
`
};

완벽한 사용자 정의를 위해 src/index.ts 에서 get_style_guide 핸들러 전체를 수정할 수 있습니다.

프로젝트 구조

src/index.ts : 주요 MCP 서버 구현
src/api/ : FindMine API 클라이언트
src/services/ : 비즈니스 로직 및 서비스 계층
src/types/ : TypeScript 유형 정의
src/utils/ : 유틸리티 함수 및 도우미

API 예제

스타일 가이드 받기

{
  "name": "get_style_guide",
  "arguments": {
    "category": "color_theory",
    "occasion": "wedding"
  }
}

완벽한 룩을 완성하세요

{
  "name": "get_complete_the_look",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789"
  }
}

시각적으로 유사한 제품 얻기

{
  "name": "get_visually_similar",
  "arguments": {
    "product_id": "P12345",
    "product_color_id": "C789",
    "limit": 5
  }
}

출판

npm에 게시하기

# Login to npm
npm login

# Publish the package
npm publish

# Update the version for future releases
npm version patch

Docker Hub에 게시

# Build the Docker image
docker build -t findmine/mcp-server:latest .

# Login to Docker Hub
docker login

# Push the image
docker push findmine/mcp-server:latest

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.