Sketchfab

Servidor MCP Sketchfab

Um servidor Model Context Protocol (MCP) para interagir com a plataforma de modelos 3D do Sketchfab. Este MCP permite que você pesquise, visualize detalhes e baixe modelos 3D do Sketchfab diretamente pelo Claude ou Cursor.

Recursos

• Buscar Modelos 3D: Encontre modelos no Sketchfab usando palavras-chave, tags e categorias
• Ver Detalhes do Modelo: Obtenha informações abrangentes sobre modelos específicos
• Baixar Modelos: Baixe modelos em vários formatos (gltf, glb, usdz, source)

Pré-requisitos

• Node.js 18 ou superior
• Uma chave de API do Sketchfab (para autenticação)

Instalação

1. Clone este repositório
2. Instale as dependências:

   npm install
   

3. Compile o projeto:

   npm run build
   

Uso

Executando o servidor MCP

npm start

Para fornecer sua chave de API do Sketchfab, use o parâmetro --api-key:

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

Alternativamente, você pode definir a variável de ambiente SKETCHFAB_API_KEY:

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

Ferramentas Disponíveis

1. sketchfab-search

Busque modelos 3D no Sketchfab com base em palavras-chave e filtros.

Parâmetros:

• query (opcional): Consulta de busca por texto (ex.: "carro", "casa", "personagem")
• tags (opcional): Filtrar por tags específicas (ex.: ["animated", "rigged", "pbr"])
• categories (opcional): Filtrar por categorias (ex.: ["characters", "architecture", "vehicles"])
• downloadable (opcional): Defina como true para mostrar apenas modelos que podem ser baixados
• limit (opcional): Número máximo de resultados a retornar (1-24, padrão: 10)

2. sketchfab-model-details

Obtenha informações detalhadas sobre um modelo específico do Sketchfab.

Parâmetros:

• modelId: O ID único do modelo do Sketchfab

3. sketchfab-download

Baixe um modelo 3D do Sketchfab.

Parâmetros:

• modelId: O ID único do modelo do Sketchfab a ser baixado
• format (opcional): Formato preferido para baixar o modelo (gltf, glb, usdz, source)
• outputPath (opcional): Diretório local ou caminho do arquivo para salvar o arquivo baixado

Uso com o Cursor

1. Vá em Configurações do Cursor -> MCP -> Adicionar novo servidor MCP
2. Configure seu MCP:
   • Nome: Sketchfab MCP
   • Tipo: comando
   • Comando: node /path/to/build/index.js --api-key YOUR_API_KEY

Uso com o Claude Desktop

Adicione a seguinte configuração MCP ao seu arquivo de configuração do Claude Desktop:

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

Variáveis de Ambiente

Você pode definir as seguintes variáveis de ambiente:

• SKETCHFAB_API_KEY: Sua chave de API do Sketchfab (alternativa para passá-la com o parâmetro --api-key)

Licença

ISC