Sketchfab 模型平台

你是否曾经希望AI能够直接搜索、查看和下载3D模型，而无需手动浏览网站？今天要介绍的开源项目Sketchfab模型平台，正是为了实现这个目标而设计的。它是一个MCP服务器，允许通过Claude或Cursor与Sketchfab的3D模型平台进行交互，使用户能够直接从人工智能界面搜索、查看详细信息和下载3D模型。

项目基本信息

一、项目介绍

Sketchfab模型平台是一个让AI能够与Sketchfab.com交互的MCP工具。Sketchfab是全球最大的3D模型平台之一，拥有数百万个模型。通过这个MCP服务器，你可以在AI对话中搜索、查看和下载3D模型。

这个服务器提供了三个核心工具：

• sketchfab-search：搜索3D模型
• sketchfab-model-details：获取模型详细信息
• sketchfab-download：下载3D模型

二、核心优势

3D模型搜索

使用关键字、标签和类别在Sketchfab上查找模型。

多格式下载

支持gltf、glb、usdz、source等多种格式。

详细信息获取

获取模型的全面信息，包括作者、面数等。

灵活过滤

支持按可下载性、标签、类别过滤。

易于集成

可与Cursor、Claude Desktop等无缝集成。

三、适用场景

3D内容创作

AI可以帮你搜索和获取3D模型用于项目。

游戏开发

快速获取游戏所需的3D资产。

AR/VR应用

下载适合增强现实和虚拟现实的模型。

设计参考

搜索模型作为设计参考或灵感来源。

四、安装教程

系统要求

安装步骤

第一步：获取Sketchfab API密钥

1. 登录Sketchfab账户
2. 进入开发者设置
3. 创建API密钥

第二步：克隆项目并构建

git clone https://github.com/gregkop/sketchfab-mcp.git
cd sketchfab-mcp
npm install
npm run build

第三步：配置MCP客户端

对于Cursor：

1. 转到Cursor设置 -> MCP -> 添加新的MCP服务器

2. 配置：

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

对于Claude Desktop：

找到配置文件，添加：

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

第四步：使用环境变量（可选）

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

五、使用示例

示例1：搜索3D模型

用户指令：“搜索汽车相关的3D模型，只显示可下载的”

AI会调用sketchfab-search工具：

{
  "query": "car",
  "downloadable": true,
  "limit": 10
}

示例2：按标签和类别搜索

{
  "query": "character",
  "tags": ["animated", "rigged"],
  "categories": ["characters"],
  "downloadable": true
}

示例3：获取模型详情

用户指令：“查看模型abc123的详细信息”

AI会调用sketchfab-model-details工具：

{
  "modelId": "abc123"
}

示例4：下载模型

用户指令：“下载模型abc123为glb格式，保存到/models目录”

AI会调用sketchfab-download工具：

{
  "modelId": "abc123",
  "format": "glb",
  "outputPath": "/models"
}

示例5：使用选项控制搜索

{
  "query": "house",
  "categories": ["architecture"],
  "limit": 5,
  "downloadable": true
}

六、参数说明

搜索参数

下载格式

• gltf：GL传输格式
• glb：二进制GL传输格式
• usdz：通用场景描述格式
• source：源文件格式

七、常见问题

问题1：API密钥无效

解决方案：检查Sketchfab API密钥是否正确，确认账户有效。

问题2：模型不可下载

解决方案：确认模型有下载权限，检查downloadable参数。

问题3：下载格式不支持

解决方案：确认模型支持所请求的格式。

问题4：搜索无结果

解决方案：尝试不同的搜索词，减少过滤条件。

问题5：Node.js版本要求

解决方案：需要Node.js 18或更高版本。

八、总结

Sketchfab模型平台是一个让AI能够搜索、查看和下载3D模型的MCP工具，与Sketchfab平台无缝集成。

这个项目的最大价值在于：

1. 3D模型搜索：找模型不再需要手动浏览
2. 多格式下载：gltf、glb、usdz等
3. 详细信息：了解模型的全面信息
4. 灵活过滤：按标签、类别筛选
5. ISC许可证：可自由使用

如果你需要在项目中快速获取3D模型，Sketchfab模型平台是一个非常实用的工具。