🚀 Sketchfab MCP 服务器
Sketchfab MCP 服务器是一个用于与 Sketchfab 的 3D 模型平台交互的模型上下文协议（MCP）服务器。借助此 MCP，您能够直接通过 Claude 或 Cursor 在 Sketchfab 上搜索、查看 3D 模型的详细信息并进行下载，为 3D 模型的获取提供了便捷途径。
🚀 快速开始
在使用 Sketchfab MCP 服务器之前，您需要满足一些先决条件，然后按照安装指南进行操作，最后就可以开始使用服务器提供的各项功能啦。
✨ 主要特性
- 搜索 3D 模型：支持使用关键词、标签和类别在 Sketchfab 上精准查找模型。
- 查看模型详细信息：能够获取特定模型的全面信息，让您对模型有更深入的了解。
- 下载模型：可选择以多种格式（gltf, glb, usdz, source）下载 Sketchfab 上的模型。
📦 安装指南
- 克隆此仓库。
- 安装依赖：
npm install
- 构建项目：
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 模型的唯一 IDformat（可选）：下载模型时首选的格式（gltf, glb, usdz, source）outputPath（可选）：保存下载文件的本地目录或文件路径
📚 详细文档
与 Cursor 集成
- 转到 Cursor 设置 -> MCP -> 添加新的 MCP 服务器。
- 配置您的 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 许可证。