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