Tripo AI MCP 서버

이 서버는 Tripo3D AI API를 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. AI 어시스턴트가 Tripo의 3D 생성 기능을 활용할 수 있게 해줍니다.

기능

• 텍스트 기반 3D 생성: 텍스트 프롬프트에서 3D 모델을 생성합니다.

• 이미지 기반 3D 생성: 이미지에서 3D 모델을 생성합니다(로컬 경로, URL 또는 사전 업로드된 토큰 지원).

• 다중 뷰 기반 3D 생성: 다중 뷰 이미지에서 3D 모델을 생성합니다(로컬 경로, URL 또는 토큰).

• 모델 정교화: 초안 모델의 품질을 향상합니다.

• 스타일화: 모델에 스타일(레고, 복셀, 보로노이, 마인크래프트)을 적용합니다.

• 모델 텍스처링: 기존 모델의 텍스처를 다시 입히며, 텍스트나 이미지 프롬프트로 가이드를 제공할 수 있습니다.

• 모델 변환: 모델을 다른 형식(GLTF, FBX, OBJ, STL, USDZ, 3MF)으로 내보냅니다.

• 애니메이션 워크플로우: 리깅 가능 여부 확인 → 모델 리깅 → 사전 설정된 애니메이션 리타겟팅.

• 작업 상태: 생성 작업의 상태를 확인하고 출력 URL을 가져옵니다.

• 파일 업로드: 로컬 이미지 파일을 업로드하고 재사용 가능한 파일 토큰을 받습니다.

Related MCP server: Tripo3D MCP

설치

npm install -g tripo-ai-mcp-server

구성

Tripo3D API 시크릿이 필요합니다. .env 파일에 설정하거나 환경 변수 TRIPO_API_SECRET으로 전달할 수 있습니다.

클라이언트 구성

Claude Desktop

claude_desktop_config.json (Windows의 경우 보통 %APPDATA%\Claude\claude_desktop_config.json, macOS의 경우 ~/Library/Application Support/Claude/claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "tripo-ai": {
      "command": "npx",
      "args": [
        "-y",
        "tripo-ai-mcp-server"
      ],
      "env": {
        "TRIPO_API_SECRET": "your_api_secret_here"
      }
    }
  }
}

사용법

서버 시작:

tripo-ai-mcp-server

도구

• text_to_3d: 텍스트 설명에서 3D 모델을 생성합니다.

• image_to_3d: 이미지(로컬 경로, URL 또는 사전 업로드된 토큰)에서 3D 모델을 생성합니다.

• multiview_to_3d: 다중 뷰 이미지에서 3D 모델을 생성합니다.

• get_task_status: 작업 상태를 확인하고 출력 모델 URL을 가져옵니다.

• upload_file: 로컬 이미지 파일을 업로드하고 재사용 가능한 파일 토큰을 받습니다.

• refine_model: 초안 모델을 정교화하여 품질을 향상합니다.

• animate_prerigcheck: 모델이 리깅에 적합한지 확인합니다.

• rig_model: 모델을 애니메이션할 수 있도록 리깅합니다.

• retarget_animation: 리깅된 모델에 사전 설정된 애니메이션을 적용합니다.

• stylize_model: 모델에 시각적 스타일(레고, 복셀, 보로노이, 마인크래프트)을 적용합니다.

• convert_model: 모델을 다른 파일 형식(GLTF, FBX, OBJ, STL, USDZ, 3MF)으로 변환합니다.

• texture_model: 기존 모델에 대한 새로운 텍스처를 생성합니다.

개발

1. 저장소를 복제합니다.

2. npm install

3. npm run build

4. node dist/index.js

npm에 게시하기

GitHub Actions 워크플로우(.github/workflows/publish.yml)는 새로운 GitHub 릴리스가 생성될 때마다 자동으로 패키지를 npm에 게시합니다.

일회성 설정:

1. npmjs.com → 아바타 → Access Tokens → Generate New Token → Automation에서 npm Automation 토큰을 생성합니다.

2. GitHub의 저장소 시크릿으로 추가합니다: Settings → Secrets and variables → Actions → New repository secret → 이름을 NPM_TOKEN으로 설정합니다.

새 버전 릴리스:

1. package.json에서 "version"을 업데이트합니다.

2. 커밋하고 푸시합니다.

3. 새로운 GitHub 릴리스를 생성합니다(버전 태그 지정, 예: v1.1.0). 워크플로우가 자동으로 트리거되어 npm에 게시됩니다.

라이선스

ISC