Sketchfab MCP Server

🚀 Sketchfab MCP 服務器

Sketchfab MCP 服務器是一個用於與 Sketchfab 的 3D 模型平臺交互的模型上下文協議（MCP）服務器。藉助此 MCP，您能夠直接通過 Claude 或 Cursor 在 Sketchfab 上搜索、查看 3D 模型的詳細信息並進行下載，為 3D 模型的獲取提供了便捷途徑。

🚀 快速開始

在使用 Sketchfab MCP 服務器之前，您需要滿足一些先決條件，然後按照安裝指南進行操作，最後就可以開始使用服務器提供的各項功能啦。

✨ 主要特性

• 搜索 3D 模型：支持使用關鍵詞、標籤和類別在 Sketchfab 上精準查找模型。
• 查看模型詳細信息：能夠獲取特定模型的全面信息，讓您對模型有更深入的瞭解。
• 下載模型：可選擇以多種格式（gltf, glb, usdz, source）下載 Sketchfab 上的模型。

📦 安裝指南

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（可選）：按特定標籤篩選（例如，["動畫"，" rigged"，" 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, source）
• 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 許可證。