trident-mcp

trident-mcp es un servidor MCP en Go para la generación y postprocesamiento de modelos 3D asistidos por IA.

El servidor es agnóstico al cliente y funciona de forma independiente con cualquier cliente compatible con MCP. No necesita habilidades complementarias ni servidores MCP adicionales para utilizar las herramientas principales de generación 3D, sondeo, descarga y postprocesamiento.

Actualmente se distribuye con un proveedor basado en Tripo y expone herramientas para:

• generación de texto a 3D

• generación de imagen a 3D

• generación de multivista a 3D

• sondeo de tareas asíncronas

• descarga de modelos

• retopología

• conversión de formatos

• estilización

• inspección del catálogo de modelos y configuración del servidor

Requisitos

• Go 1.25+

• Una clave de API de Tripo en TRIPO_API_KEY

Instalación

Compilar localmente:

go build ./cmd/trident-mcp

O instalar con Go:

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

Configuración

El servidor lee la configuración de las variables de entorno:

Ejecución

El servidor utiliza MCP a través de stdio:

TRIPO_API_KEY=tsk_your_key_here trident-mcp

Ejemplo de configuración de cliente MCP:

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

Herramientas

Generación

• text_to_3d

• image_to_3d

• multiview_to_3d

Estas herramientas inician tareas asíncronas. Utilice task_status para verificar la finalización y, a continuación, download_model para recuperar el resultado de la tarea.

Estado y descarga

• task_status

• download_model

download_model guarda el formato de salida real de la tarea. Si necesita un formato diferente, ejecute convert_format primero y luego descargue la tarea de conversión.

Postprocesamiento

• retopologize

• convert_format

• stylize

Introspección

• list_models

• get_config

get_config informa sobre el backend activo, el directorio de salida y la versión del servidor.

Habilidades

El repositorio también incluye habilidades de agente complementarias en skills/:

• skills/3d-gen/SKILL.md

• skills/multiview-3d/SKILL.md

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

Estas habilidades son opcionales. El servidor MCP en sí funciona perfectamente por sí solo en cualquier cliente MCP.

Algunas de las habilidades complementarias están diseñadas para combinar trident-mcp con gemini-media-mcp para un flujo de trabajo automatizado más completo. En esa configuración, gemini-media-mcp puede ayudar con la ideación, la generación de imágenes de referencia y la creación de imágenes multiángulo, mientras que trident-mcp se encarga de la reconstrucción y el postprocesamiento. Esa combinación permite un flujo más completo desde la idea hasta el modelo 3D terminado.

Desarrollo

Ejecute las comprobaciones locales:

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

También hay una prueba de humo E2E opcional para subidas en vivo a Tripo:

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

Lanzamiento

GitHub Actions ejecuta comprobaciones unitarias en los pushes y pull requests, y ejecuta la prueba de humo E2E en main y en las etiquetas de versión. Las versiones etiquetadas se compilan con GoReleaser.

Los artefactos se marcan con la versión de lanzamiento para que los metadatos del binario y de la implementación de MCP se mantengan alineados.