Sketchfab MCP Server

A Model Context Protocol (MCP) server for searching and downloading 3D models from Sketchfab.

Features

• Search for 3D models on Sketchfab by keywords, tags, and categories
• Filter for downloadable models only
• Get detailed information about specific models
• Download models in various formats (gltf, glb, usdz, source)
• Save models to specified locations or a temp directory

Prerequisites

• Node.js 18.0.0 or higher
• A Sketchfab API key (Get one here)

Installation

# Clone the repository
git clone https://github.com/yourusername/sketchfab-mcp-server.git
cd sketchfab-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Optional: Link globally
npm link

Usage

As a Library

import { main } from 'sketchfab-mcp-server';

// Start the MCP server
main();

As a Command-Line Tool

If you've linked the package globally:

sketchfab-mcp --api-key=YOUR_SKETCHFAB_API_KEY

Using npx (if published to npm):

npx -y sketchfab-mcp-server --api-key=YOUR_SKETCHFAB_API_KEY

Or directly:

npm start

Command-Line Options

Options:
  --api-key     Your Sketchfab API key                       [string]
  --tools       Comma-separated list of tools to enable, or "all" for all tools
                                                      [string] [default: "all"]
  --debug       Enable debug logging                [boolean] [default: false]
  -h, --help    Show help                                    [boolean]

Examples:

# Start with all tools and your API key
npx -y sketchfab-mcp-server --api-key=YOUR_SKETCHFAB_API_KEY

# Start with only Sketchfab search tool and enable debugging
npx -y sketchfab-mcp-server --api-key=YOUR_SKETCHFAB_API_KEY --tools=sketchfab-search --debug

Tools

This MCP server provides the following tools:

sketchfab-search

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

{
  "name": "sketchfab-search",
  "arguments": {
    "apiKey": "your-sketchfab-api-key",
    "query": "dragon",
    "tags": ["fantasy", "creature"],
    "categories": ["characters"],
    "downloadable": true,
    "limit": 10
  }
}

sketchfab-model-details

Get detailed information about a specific Sketchfab model.

{
  "name": "sketchfab-model-details",
  "arguments": {
    "apiKey": "your-sketchfab-api-key",
    "modelId": "model-uid"
  }
}

sketchfab-download

Download a 3D model from Sketchfab.

{
  "name": "sketchfab-download",
  "arguments": {
    "apiKey": "your-sketchfab-api-key",
    "modelId": "model-uid",
    "format": "gltf",
    "outputPath": "/path/to/save/model"
  }
}

Development

# Run in development mode with hot reloading
npm run dev

# Run tests
npm test

# Run linting
npm run lint

Testing with MCP Inspector

You can use the MCP Inspector to visually test and debug the server:

npx @modelcontextprotocol/inspector node dist/index.js

Then open the inspector UI at http://localhost:5173

Local Testing with Cursor

To test your MCP server locally with Cursor:

1. Build and link the package:

   npm run build
   npm run link
   

2. Verify the binary works:

   sketchfab-mcp
   

3. Add the server to Cursor:

   • Open Cursor settings
   • Navigate to the Features tab
   • Scroll down to MCP Servers section
   • Click "Add Server"
   • Select "Command" type
   • Give it a name (e.g., "Sketchfab MCP Server")
   • Enter the command: sketchfab-mcp
   • Click Confirm

4. Verify the server starts correctly in Cursor by checking the MCP Servers section shows your server as running.

License

MIT