Sketchfab MCP Server

Sketchfab MCP 服务器

一个用于与 Sketchfab 3D 模型平台交互的模型上下文协议 (MCP) 服务器。此 MCP 允许您直接通过 Claude 或 Cursor 从 Sketchfab 搜索、查看详细信息以及下载 3D 模型。

特征

• 搜索 3D 模型：使用关键字、标签和类别在 Sketchfab 上查找模型
• 查看模型详细信息：获取有关特定模型的全面信息
• 下载模型：下载各种格式的模型（gltf、glb、usdz、source）

先决条件

• Node.js 18 或更高版本
• Sketchfab API 密钥（用于身份验证）

安装

1. 克隆此存储库
2. 安装依赖项：
   npm install
3. 构建项目：
   npm run build

用法

运行 MCP 服务器

要提供您的 Sketchfab API 密钥，请使用--api-key参数：

或者，您可以设置SKETCHFAB_API_KEY环境变量：

可用工具

1. sketchfab-搜索

根据关键字和过滤器在 Sketchfab 上搜索 3D 模型。

参数：

• query （可选）：文本搜索查询（例如，“汽车”，“房子”，“人物”）
• tags （可选）：按特定标签过滤（例如，[“animated”，“rigged”，“pbr”]）
• categories （可选）：按类别过滤（例如，[“characters”，“architecture”，“vehicles”]）
• downloadable （可选）：设置为 true 以仅显示可下载的模型
• limit （可选）：返回的最大结果数（1-24，默认值：10）

2. SketchFab 模型细节

获取有关特定 Sketchfab 模型的详细信息。

参数：

• modelId ：Sketchfab 模型的唯一 ID

3. Sketchfab 下载

从 Sketchfab 下载 3D 模型。

参数：

• modelId ：要下载的 Sketchfab 模型的唯一 ID
• format （可选）：下载模型的首选格式（gltf、glb、usdz、source）
• outputPath （可选）：保存下载文件的本地目录或文件路径

与游标一起使用

1. 前往“光标设置”->“MCP”->“添加新的 MCP 服务器”
2. 配置您的 MCP：
   • 名称：Sketchfab MCP
   • 类型：命令
   • 命令： node /path/to/build/index.js --api-key YOUR_API_KEY

与 Claude Desktop 一起使用

将以下 MCP 配置添加到您的 Claude Desktop 配置中：

环境变量

您可以设置以下环境变量：

• SKETCHFAB_API_KEY ：您的 Sketchfab API 密钥（也可以通过 --api-key 参数传递）

执照

国际学习中心