📌Overview

Purpose: To provide a Model Context Protocol (MCP) server for seamless interaction with Sketchfab's 3D model platform, enabling users to search, view, and download 3D models easily.

Overview: The Sketchfab MCP Server allows integration with Sketchfab, giving users the ability to access a wide array of 3D models through text queries or tags, retrieve detailed model information, and download models in various formats from the Sketchfab library. This functionality supports improved accessibility and usability for 3D content across applications.

Key Features:

Search for 3D Models: Enables users to locate models on Sketchfab using keywords, tags, and categories, helping them find specific assets quickly.
View Model Details: Provides comprehensive information about specific models, allowing users to assess models before downloading or using them.
Download Models: Allows downloading of models in multiple formats (gltf, glb, usdz, source), catering to different needs for 3D content integration.

Sketchfab MCP Server

A Model Context Protocol (MCP) server for interacting with Sketchfab's 3D model platform. This MCP allows you to search, view details, and download 3D models from Sketchfab through Claude or Cursor.

Features

Search for 3D Models: Find models using keywords, tags, and categories.
View Model Details: Get comprehensive information about specific models.
Download Models: Download models in various formats (gltf, glb, usdz, source).

Prerequisites

Node.js 18 or higher
A Sketchfab API key (for authentication)

Installation

Clone this repository.
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```

Usage

Running the MCP Server

Start the server using:

npm start

To provide your Sketchfab API key, use the --api-key parameter:

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

Alternatively, set the SKETCHFAB_API_KEY environment variable:

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

Available Tools

sketchfab-search

Search for 3D models with optional parameters:

query: Text search query (e.g., "car").
tags: Filters by specific tags (e.g., ["animated"]).
categories: Filters by categories (e.g., ["characters"]).
downloadable: Set to true to show only downloadable models.
limit: Maximum number of results (default: 10).

sketchfab-model-details

Get detailed information about a specific model using:

modelId: The unique ID of the Sketchfab model.

sketchfab-download

Download a 3D model using:

modelId: The unique ID of the Sketchfab model to download.
format: Preferred format for downloading (gltf, glb, usdz, source).
outputPath: Local directory or file path to save the downloaded file.

Using with Cursor

Go to Cursor Settings -> MCP -> Add new MCP server.
Configure your MCP:
- Name: Sketchfab MCP
- Type: command
- Command: node /path/to/build/index.js --api-key YOUR_API_KEY

Using with Claude Desktop

Add the following MCP config to your Claude Desktop configuration:

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

Environment Variables

Set the following environment variables:

SKETCHFAB_API_KEY: Your Sketchfab API key (alternative to passing it with the --api-key parameter).

License

ISC

sketchfab-mcp-server