Sketchfab

Servidor MCP de Sketchfab

Un servidor de Protocolo de Contexto de Modelo (MCP) para interactuar con la plataforma de modelos 3D de Sketchfab. Este MCP te permite buscar, ver detalles y descargar modelos 3D de Sketchfab directamente a través de Claude o Cursor.

Características

• Buscar modelos 3D: Encuentra modelos en Sketchfab usando palabras clave, etiquetas y categorías
• Ver detalles del modelo: Obtén información completa sobre modelos específicos
• Descargar modelos: Descarga modelos en varios formatos (gltf, glb, usdz, source)

Requisitos previos

• Node.js 18 o superior
• Una clave de API de Sketchfab (para autenticación)

Instalación

1. Clona este repositorio
2. Instala las dependencias:

   npm install
   

3. Compila el proyecto:

   npm run build
   

Uso

Ejecutando el servidor MCP

npm start

Para proporcionar tu clave de API de Sketchfab, usa el parámetro --api-key:

node build/index.js --api-key YOUR_API_KEY

Alternativamente, puedes configurar la variable de entorno SKETCHFAB_API_KEY:

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

Herramientas disponibles

1. sketchfab-search

Busca modelos 3D en Sketchfab según palabras clave y filtros.

Parámetros:

• query (opcional): Consulta de búsqueda de texto (por ejemplo, "coche", "casa", "personaje")
• tags (opcional): Filtrar por etiquetas específicas (por ejemplo, ["animated", "rigged", "pbr"])
• categories (opcional): Filtrar por categorías (por ejemplo, ["characters", "architecture", "vehicles"])
• downloadable (opcional): Establecer a true para mostrar solo modelos descargables
• limit (opcional): Número máximo de resultados a devolver (1-24, por defecto: 10)

2. sketchfab-model-details

Obtén información detallada sobre un modelo específico de Sketchfab.

Parámetros:

• modelId: El ID único del modelo de Sketchfab

3. sketchfab-download

Descarga un modelo 3D de Sketchfab.

Parámetros:

• modelId: El ID único del modelo de Sketchfab a descargar
• format (opcional): Formato preferido para descargar el modelo (gltf, glb, usdz, source)
• outputPath (opcional): Directorio local o ruta de archivo para guardar el archivo descargado

Uso con Cursor

1. Ve a Configuración de Cursor -> MCP -> Añadir nuevo servidor MCP
2. Configura tu MCP:
   • Nombre: Sketchfab MCP
   • Tipo: comando
   • Comando: node /path/to/build/index.js --api-key YOUR_API_KEY

Uso con Claude Desktop

Añade la siguiente configuración MCP a tu configuración de Claude Desktop:

{
  "mcpServers": {
    "sketchfab": {
      "command": "node",
      "args": ["/path/to/build/index.js", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Variables de entorno

Puedes configurar las siguientes variables de entorno:

• SKETCHFAB_API_KEY: Tu clave de API de Sketchfab (alternativa a pasarla con el parámetro --api-key)

Licencia

ISC