AI导哈

3D模型协议服务

Sketchfab MCP Server是一个用于与Sketchfab的3D模型平台交互的模型上下文协议（MCP）服务器，支持搜索、查看详情和下载3D模型。

  • by gregkop
  • JavaScript
  • 本地部署
  • 44 星标
  • 更新于
在 GitHub 查看 gregkop/sketchfab-mcp-server

使用说明

Sketchfab MCP服务器

用于与Sketchfab的3D模型平台交互的模型上下文协议（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上搜索3D模型。

参数：

  • query （可选）：文本搜索查询（例如，“汽车”、“房子”、“字符”）
  • tags （可选）：按特定标签过滤（例如，[“动画”、“操纵”、“pbr”]）
  • categories （可选）：按类别筛选（例如，[“字符”、“架构”、“车辆”]）
  • downloadable （可选）：设置为true仅显示可下载的型号
  • limit （可选）：返回的最大结果数（1-24，默认值：10）

2.草图模型细节

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

参数：

  • modelId：Sketchfab模型的唯一ID

3.草图下载

从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配置中：

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

环境变量

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

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

许可证

国际协调委员会

相关 MCP