MCP_thingiverse
Thingiverse MCP Server is a Model Context Protocol server that interfaces with the Thingiverse API to provide AI assistants the ability to search, browse, and retrieve 3D printable models. It supports features like model searching, category browsing, and random model discovery through Puppeteer's capabilities.
🌟 Overview
This MCP server wraps the Thingiverse API using Puppeteer to create a reliable interface that can be used by AI assistants. It provides tools to:
- Search for 3D printable models
- Get random 3D models
- Browse categories
- Get models from specific categories
🚀 Features
- 🔍 Model Search: Search Thingiverse's database of 3D printable models using keywords
- 🗂️ Category Browsing: Explore models by categories
- 🎲 Random Models: Discover random 3D models from Thingiverse
- 🌐 Complete API Access: Get detailed information about models, including descriptions, files, images, and more
- 🤖 AI Assistant Integration: Designed to work with AI assistants through the Model Context Protocol
📋 Prerequisites
- Node.js (v14 or higher)
- npm or yarn
- Thingiverse API token
🎮 Usage
Development Mode
This starts the MCP server in development mode with hot reload.
Production Mode
Or use the shorthand:
🔗 Integrating with Claude Desktop
To add this MCP server to Claude Desktop and enable Thingiverse browsing capabilities:
-
Start the MCP server Make sure your server is running locally or on a remote host that Claude Desktop can access.
-
Open Claude Desktop settings
-
Navigate to Extensions settings
4.1 Configure the MCP connection
-
Enable the MCP
-
Verify connection
-
Troubleshooting
🧠 Available Tools
The server exposes several tools that can be used by AI assistants:
get-things
get-random-thing
get-categories
get-random-thing-from-category
🔍 How It Works
🛠️ Project Structure
⚙️ Development
Testing
Linting and Formatting
📝 Notes for Deployment
📄 License
This project is licensed under the MIT License.