Thingiverse MCP Server

基本能力

产品定位

Thingiverse MCP Server 旨在为 AI 助手提供一个与 Thingiverse 3D 模型库交互的接口，使其能够搜索、浏览和检索 3D 可打印模型。

核心功能

• 🔍 模型搜索: 使用关键词搜索 Thingiverse 数据库中的 3D 可打印模型。
• 🗂️ 分类浏览: 按分类浏览模型。
• 🎲 随机模型: 从 Thingiverse 获取随机 3D 模型。
• 🌐 完整 API 访问: 获取模型的详细信息，包括描述、文件、图片等。
• 🤖 AI 助手集成: 通过 Model Context Protocol 与 AI 助手集成。

适用场景

• AI 助手需要搜索或浏览 3D 可打印模型时。
• 开发者需要集成 Thingiverse 功能到其应用中时。
• 用户需要快速获取随机或特定分类的 3D 模型时。

工具列表

• get-things: 根据搜索词搜索 3D 模型。
• get-random-thing: 获取随机 3D 模型。
• get-categories: 获取所有可用分类。
• get-random-thing-from-category: 从特定分类获取随机 3D 模型。

常见问题解答

• 如何获取 API 令牌？ 从 Thingiverse 开发者门户获取 App Token，并配置到 .env.development 和 .env.production 文件中。
• 如何验证连接？ 启动服务后，在 Claude Desktop 中启用 MCP 并验证连接。

使用教程

使用依赖

• Node.js (v14 或更高版本)
• npm 或 yarn
• Thingiverse API 令牌

安装教程

1. 克隆仓库 bash git clone <repository-url> cd thingiverse-mcp

2. 安装依赖 bash npm install

3. 设置环境变量 bash cp .env.example .env.development cp .env.example .env.production

4. 配置 API 令牌 在 .env.development 和 .env.production 文件中添加： APP_TOKEN=your_api_token_here

调试方式

• 开发模式 bash npm run dev

• 生产模式 bash npm run build npm start 或 bash npm run prod

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。