Sketchfab MCP Server

by MCP-Mirror

310 downloads
Not rated
GitHub

About

A Model Context Protocol (MCP) server that lets you search, view details, and download 3D models from Sketchfab directly through Claude or Cursor. It is built for anyone who wants to access Sketchfab's 3D model platform programmatically via an AI assistant.

Details

Author
MCP-Mirror
Downloads
310
Categories
Other

- Search for 3D models using keywords, tags, and categories
- View comprehensive information about specific models
- Download models in gltf, glb, usdz, or source format
- Filter results by downloadable status and result limit

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Sketchfab MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install Node.js 18+, clone the repository, run npm install and npm run build. Start with npm start or node build/index.js --api-key YOUR_API_KEY. You can also set the SKETCHFAB_API_KEY environment variable. Configure it as an MCP server in Cursor Settings or Claude Desktop by pointing to the built index.js with your API key.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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 directly through Claude or Cursor.

Features

- Search for 3D Models: Find models on Sketchfab 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

1. Clone this repository
2. Install dependencies:

   npm install

3. Build the project:
   npm run build

Usage

Running the MCP Server

npm start

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

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

Alternatively, you can set the SKETCHFAB_API_KEY environment variable:

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

Available Tools

1. sketchfab-search

Search for 3D models on Sketchfab based on keywords and filters.

Parameters:
- query (optional): Text search query (e.g., "car", "house", "character")
- tags (optional): Filter by specific tags (e.g., ["animated", "rigged", "pbr"])
- categories (optional): Filter by categories (e.g., ["characters", "architecture", "vehicles"])
- downloadable (optional): Set to true to show only downloadable models
- limit (optional): Maximum number of results to return (1-24, default: 10)

2. sketchfab-model-details

Get detailed information about a specific Sketchfab model.

Parameters:
- modelId: The unique ID of the Sketchfab model

3. sketchfab-download

Download a 3D model from Sketchfab.

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

Using with Cursor

1. Go to Cursor Settings -> MCP -> Add new MCP server
2. 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

You can set the following environment variables:

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

License

ISC

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.