FindMine 쇼핑 스타일리스트
FindMine의 강력한 제품 스타일링 및 의류 추천 기능을 Claude 및 기타 MCP 호환 애플리케이션과 통합하는 MCP(Model Context Protocol) 서버입니다.
개요
이 MCP 서버는 FindMine의 스타일링 API에 연결하고 모델 컨텍스트 프로토콜을 통해 대규모 언어 모델(Large Language Models)에 해당 기능을 제공합니다. 사용자는 다음을 수행할 수 있습니다.
제품 및 의상 정보 탐색
특정 제품에 대한 의상 추천을 받으세요
시각적으로 유사한 제품 찾기
스타일 가이드 및 패션 조언에 액세스하세요
Related MCP server: Perplexity MCP Server
특징
자원
제품 :
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 애플리케이션 ID | 데모 앱 ID |
| 사용할 API 버전 | v3 |
| 기본 지역 코드 | 우리를 |
| 기본 언어 코드 | 엔 |
| 응답 캐싱 활성화 | 진실 |
| 캐시 수명(ms) | 3600000(1시간) |
| 샘플 데이터의 경우 "개발"로 설정 | - |
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 patchDocker 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 라이선스에 따라 라이선스가 부여되었습니다.