Sketchfab MCP Server

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 permite buscar, ver detalles y descargar modelos 3D de Sketchfab directamente a través de Claude o Cursor.

Características

• Búsqueda de modelos 3D : encuentre modelos en Sketchfab usando palabras clave, etiquetas y categorías
• Ver detalles del modelo : Obtenga información completa sobre modelos específicos
• Descargar modelos : Descarga modelos en varios formatos (gltf, glb, usdz, source)

Prerrequisitos

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

Instalación

1. Clonar este repositorio
2. Instalar dependencias:
   npm install
3. Construir el proyecto:
   npm run build

Uso

Ejecución del servidor MCP

Para proporcionar su clave API de Sketchfab, utilice el parámetro --api-key :

Alternativamente, puede configurar la variable de entorno SKETCHFAB_API_KEY :

Herramientas disponibles

1. búsqueda en sketchfab

Busque 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, ["animado", "manipulado", "pbr"])
• categories (opcional): Filtrar por categorías (por ejemplo, ["personajes", "arquitectura", "vehículos"])
• downloadable (opcional): Establézcalo como verdadero para mostrar solo los modelos descargables
• limit (opcional): número máximo de resultados a devolver (1-24, predeterminado: 10)

2. detalles del modelo de sketchfab

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

Parámetros:

• modelId : El ID único del modelo de Sketchfab

3. descarga de sketchfab

Descargue un modelo 3D de Sketchfab.

Parámetros:

• modelId : El ID único del modelo de Sketchfab para 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. Vaya a Configuración del cursor -> MCP -> Agregar 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

Agregue la siguiente configuración de MCP a su configuración de Claude Desktop:

Variables de entorno

Puede configurar las siguientes variables de entorno:

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

Licencia

ISC