Sketchfab MCP 서버

Sketchfab의 3D 모델 플랫폼과 상호 작용하기 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP를 사용하면 Claude 또는 Cursor를 통해 Sketchfab에서 3D 모델을 직접 검색하고, 세부 정보를 확인하고, 다운로드할 수 있습니다.

특징

• 3D 모델 검색 : 키워드, 태그, 카테고리를 사용하여 Sketchfab에서 모델 찾기
• 모델 세부 정보 보기 : 특정 모델에 대한 포괄적인 정보를 얻으세요
• 모델 다운로드 : 다양한 형식(gltf, glb, usdz, source)의 모델을 다운로드하세요

필수 조건

• Node.js 18 이상
• Sketchfab API 키(인증용)

설치

1. 이 저장소를 복제하세요
2. 종속성 설치:지엑스피1
3. 프로젝트를 빌드하세요:
   npm run build

용법

MCP 서버 실행

Sketchfab API 키를 제공하려면 --api-key 매개변수를 사용하세요.

또는 SKETCHFAB_API_KEY 환경 변수를 설정할 수 있습니다.

사용 가능한 도구

1. 스케치팹 검색

키워드와 필터를 기반으로 Sketchfab에서 3D 모델을 검색하세요.

매개변수:

• query (선택 사항): 텍스트 검색 쿼리(예: "자동차", "집", "문자")
• tags (선택 사항): 특정 태그로 필터링(예: ["애니메이션", "조작", "PBR"])
• categories (선택 사항): 카테고리별로 필터링합니다(예: ["캐릭터", "건축", "차량"])
• downloadable (선택 사항): 다운로드 가능한 모델만 표시하려면 true로 설정합니다.
• limit (선택 사항): 반환할 최대 결과 수(1-24, 기본값: 10)

2. 스케치팹-모델-디테일

특정 Sketchfab 모델에 대한 자세한 정보를 얻으세요.

매개변수:

• modelId : Sketchfab 모델의 고유 ID

3. 스케치팹 다운로드

Sketchfab에서 3D 모델을 다운로드하세요.

매개변수:

• modelId : 다운로드할 Sketchfab 모델의 고유 ID
• format (선택 사항): 모델을 다운로드하는 데 선호하는 형식(gltf, glb, usdz, source)
• outputPath (선택 사항): 다운로드한 파일을 저장할 로컬 디렉토리 또는 파일 경로

커서와 함께 사용

1. 커서 설정 -> MCP -> 새 MCP 서버 추가로 이동하세요.
2. MCP를 구성하세요:
   • 이름: Sketchfab MCP
   • 유형: 명령
   • 명령어: node /path/to/build/index.js --api-key YOUR_API_KEY

Claude Desktop과 함께 사용

다음 MCP 구성을 Claude Desktop 구성에 추가하세요.

환경 변수

다음 환경 변수를 설정할 수 있습니다.

• SKETCHFAB_API_KEY : Sketchfab API 키(--api-key 매개변수와 함께 전달하는 대안)

특허

아이에스씨