Servidor MCP de Tripo AI

Este es un servidor del Protocolo de Contexto de Modelo (MCP) para la API de Tripo3D AI. Permite que los asistentes de IA interactúen con las capacidades de generación 3D de Tripo.

Características

• Texto a 3D: Genera modelos 3D a partir de prompts de texto.

• Imagen a 3D: Genera modelos 3D a partir de imágenes (admite rutas locales, URLs o tokens pre-cargados).

• Multivista a 3D: Genera modelos 3D a partir de imágenes de múltiples vistas (rutas locales, URLs o tokens).

• Refinar modelo: Mejora la calidad de un modelo borrador.

• Estilización: Aplica estilos (lego, voxel, voronoi, minecraft) a un modelo.

• Texturizar modelo: Re-texturiza un modelo existente, opcionalmente guiado por un prompt de texto o imagen.

• Convertir modelo: Exporta un modelo a un formato diferente (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• Flujo de trabajo de animación: Comprobar capacidad de rigging → riggear un modelo → retargetizar una animación preestablecida.

• Estado de la tarea: Comprueba el estado y recupera las URLs de salida de cualquier tarea de generación.

• Subir archivo: Sube un archivo de imagen local y recibe un token de archivo reutilizable.

Related MCP server: Tripo3D MCP

Instalación

npm install -g tripo-ai-mcp-server

Configuración

Necesitas un secreto de API de Tripo3D. Puedes configurarlo en un archivo .env o pasarlo como una variable de entorno TRIPO_API_SECRET.

Configuración del cliente

Claude Desktop

Añade lo siguiente a tu claude_desktop_config.json (normalmente se encuentra en %APPDATA%\Claude\claude_desktop_config.json en Windows o ~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

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

Uso

Inicia el servidor:

tripo-ai-mcp-server

Herramientas

• text_to_3d: Genera un modelo 3D a partir de una descripción de texto.

• image_to_3d: Genera un modelo 3D a partir de una imagen (ruta local, URL o token pre-cargado).

• multiview_to_3d: Genera un modelo 3D a partir de imágenes de múltiples vistas.

• get_task_status: Comprueba el estado de la tarea y recupera las URLs del modelo de salida.

• upload_file: Sube un archivo de imagen local y recibe un token de archivo reutilizable.

• refine_model: Refina un modelo borrador para mejorar la calidad.

• animate_prerigcheck: Comprueba si un modelo es adecuado para el rigging.

• rig_model: Riggea un modelo para que pueda ser animado.

• retarget_animation: Aplica una animación preestablecida a un modelo riggeado.

• stylize_model: Aplica un estilo visual a un modelo (lego, voxel, voronoi, minecraft).

• convert_model: Convierte un modelo a un formato de archivo diferente (GLTF, FBX, OBJ, STL, USDZ, 3MF).

• texture_model: Genera nuevas texturas para un modelo existente.

Desarrollo

1. Clona el repositorio.

2. npm install

3. npm run build

4. node dist/index.js

Publicación en npm

Un flujo de trabajo de GitHub Actions (.github/workflows/publish.yml) publica automáticamente el paquete en npm cada vez que se crea una nueva versión (Release) en GitHub.

Configuración única:

1. Genera un token de Automation de npm en npmjs.com → Avatar → Access Tokens → Generate New Token → Automation.

2. Añádelo como un secreto de repositorio en GitHub: Settings → Secrets and variables → Actions → New repository secret → nómbralo NPM_TOKEN.

Para lanzar una nueva versión:

1. Incrementa la "version" en package.json.

2. Haz commit y push.

3. Crea una nueva versión en GitHub (etiquétala con la versión, p. ej., v1.1.0). El flujo de trabajo se activa automáticamente y publica en npm.

Licencia

ISC