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)

Related MCP server: SketchupMCP

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