trident-mcp

trident-mcp는 AI 지원 3D 모델 생성 및 후처리를 위한 Go MCP 서버입니다.

이 서버는 클라이언트 독립적이며 모든 MCP 호환 클라이언트와 독립적으로 작동합니다. 핵심 3D 생성, 폴링, 다운로드 및 후처리 도구를 사용하기 위해 별도의 컴패니언 스킬이나 추가 MCP 서버가 필요하지 않습니다.

현재 Tripo 기반 제공자를 탑재하고 있으며 다음을 위한 도구를 제공합니다:

• 텍스트-to-3D 생성

• 이미지-to-3D 생성

• 다중 뷰-to-3D 생성

• 비동기 작업 폴링

• 모델 다운로드

• 리토폴로지

• 형식 변환

• 스타일화

• 모델 카탈로그 및 서버 구성 검사

요구 사항

• Go 1.25+

• TRIPO_API_KEY에 설정된 Tripo API 키

설치

로컬에서 빌드:

go build ./cmd/trident-mcp

또는 Go를 사용하여 설치:

go install github.com/mordor-forge/trident-mcp/cmd/trident-mcp@latest

구성

서버는 환경 변수에서 구성을 읽습니다:

실행

서버는 stdio를 통해 MCP를 통신합니다:

TRIPO_API_KEY=tsk_your_key_here trident-mcp

예시 MCP 클라이언트 구성:

{
  "mcpServers": {
    "trident-mcp": {
      "command": "trident-mcp",
      "env": {
        "TRIPO_API_KEY": "tsk_your_key_here",
        "MODEL_OUTPUT_DIR": "/absolute/path/to/generated_models"
      }
    }
  }
}

도구

생성

• text_to_3d

• image_to_3d

• multiview_to_3d

이 도구들은 비동기 작업을 시작합니다. task_status를 사용하여 완료 여부를 폴링한 다음, download_model을 사용하여 작업 결과를 가져옵니다.

상태 및 다운로드

• task_status

• download_model

download_model은 작업의 실제 출력 형식을 저장합니다. 다른 형식이 필요한 경우, 먼저 convert_format을 실행한 다음 변환 작업을 다운로드하십시오.

후처리

• retopologize

• convert_format

• stylize

인트로스펙션

• list_models

• get_config

get_config는 활성 백엔드, 출력 디렉토리 및 서버 버전을 보고합니다.

스킬

이 저장소에는 skills/ 하위에 컴패니언 에이전트 스킬도 포함되어 있습니다:

• skills/3d-gen/SKILL.md

• skills/multiview-3d/SKILL.md

• skills/3d-to-blender/SKILL.md

이 스킬들은 선택 사항입니다. MCP 서버 자체는 모든 MCP 클라이언트에서 단독으로 잘 작동합니다.

일부 컴패니언 스킬은 더 완전한 자동화 파이프라인을 위해 trident-mcp를 gemini-media-mcp와 결합하도록 설계되었습니다. 해당 설정에서 gemini-media-mcp는 아이디어 구상, 참조 이미지 생성 및 다각도 이미지 생성을 돕고, trident-mcp는 재구성 및 후처리를 담당합니다. 이러한 조합을 통해 아이디어에서 완성된 3D 모델까지의 더 완전한 흐름이 가능해집니다.

개발

로컬 검사 실행:

go test ./...
go vet ./...

라이브 Tripo 업로드를 위한 선택적 E2E 스모크 테스트도 있습니다:

TRIPO_API_KEY=tsk_your_key_here go test -tags=e2e -run "TestE2E_" ./internal/provider/tripo/ -v

릴리스

GitHub Actions는 푸시 및 풀 리퀘스트 시 단위 검사를 실행하며, main 브랜치와 버전 태그에서 E2E 스모크 테스트를 실행합니다. 태그가 지정된 릴리스는 GoReleaser로 빌드됩니다.

아티팩트에는 릴리스 버전이 스탬프 처리되어 바이너리와 MCP 구현 메타데이터가 일치하도록 유지됩니다.