Sketchfab MCP Server

🚀 Sketchfab MCP Server

A Model Context Protocol (MCP) server for interacting with Sketchfab's 3D model platform. This MCP allows you to search for, view details of, and download 3D models on 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 a specific model.
• Download models: Download models from Sketchfab in multiple formats (gltf, glb, usdz, source).

📋 Prerequisites

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

📦 Installation

1. Clone this repository.
2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

💻 Usage Examples

Run 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 filter criteria.

Parameters:

• query (optional): Text search query (e.g., "car", "house", "character").
• tags (optional): Filter by specific tags (e.g., ["animation", "rigged", "pbr"]).
• categories (optional): Filter by categories (e.g., ["character", "architecture", "vehicle"]).
• 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 model on Sketchfab.

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 when downloading the model (gltf, glb, usdz, source).
• outputPath (optional): Local directory or file path to save the downloaded file.

🤝 Integration with Cursor

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

🤝 Integration with Claude Desktop

Add the following MCP configuration 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 (as an alternative to the --api-key parameter).

📄 License

ISC