Sketchfab MCP Server

这是一个用于与Sketchfab 3D模型平台交互的Model Context Protocol (MCP)服务器。此MCP允许您通过Claude或Cursor直接搜索、查看详细信息并下载来自Sketchfab的3D模型。

功能

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

预备条件

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

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

使用方法

运行MCP服务器

npm start

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

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

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

export SKETCHFAB_API_KEY=YOUR_API_KEY
npm start

可用工具

1. sketchfab-search

基于关键词和过滤器在Sketchfab上搜索3D模型。

参数：

• query（可选）：文本搜索查询（例如，“汽车”，“房屋”，“角色”）
• tags（可选）：按特定标签过滤（例如，["动画", "装配", "PBR"]）
• categories（可选）：按类别过滤（例如，["角色", "建筑", "车辆"]）
• downloadable（可选）：设置为true仅显示可下载的模型
• limit（可选）：返回结果的最大数量（1-24，默认值：10）

2. sketchfab-model-details

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

参数：

• modelId：Sketchfab模型的唯一ID

3. sketchfab-download

从Sketchfab下载3D模型。

参数：

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

与Cursor一起使用

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

与Claude Desktop一起使用

向您的Claude Desktop配置添加以下MCP配置：

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

环境变量

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

• SKETCHFAB_API_KEY：您的Sketchfab API密钥（替代使用--api-key参数传递）

许可证

ISC