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 服务

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（可选）：文本搜索查询（例如，“car”“house”“character”）
• tags（可选）：按指定标签筛选（例如，["animated", "rigged", "pbr"]）
• categories（可选）：按类别筛选（例如，["characters", "architecture", "vehicles"]）
• 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、source）
• outputPath（可选）：用于保存下载文件的本地目录或文件路径

与 Cursor 搭配使用

1. 前往 Cursor Settings -> MCP -> Add new MCP server
2. 配置 MCP：
   • 名称：Sketchfab MCP
   • 类型：command
   • 命令：node /path/to/build/index.js --api-key YOUR_API_KEY

与 Claude Desktop 搭配使用

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

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

环境变量

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

• SKETCHFAB_API_KEY：Sketchfab API 密钥（可替代使用 --api-key 参数传入）

许可证

ISC