GhostTypes/printables-mcp-server
If you are the rightful owner of printables-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
The Printables MCP Server is designed to facilitate interaction with Printables.com, providing features for model search, file retrieval, and description scraping.
Printables MCP Server
A Model Context Protocol (MCP) server for interacting with Printables.com
Core Features
| Feature | Description |
|---|---|
| Model Search | Search for models with rich metadata. |
| File Retrieval | Get all downloadable files associated with a specific model ID. |
| Description Scraping | Fetches and formats the detailed description text from a model's main page. |
Model Search
This feature enables users to query the Printables.com database for 3D models.
| Sub-Feature | Description |
|---|---|
| Search by Term | Finds models using a specific query string (e.g., "benchy", "vase"). |
| Result Limiting | Controls the maximum number of search results returned in a single query. |
| Detailed Metadata | Returns rich information for each model, including ID, name, URL, statistics (ratings, likes, downloads), author, and image URL. |
File Retrieval
This feature provides access to the files for a given model.
| Sub-Feature | Description |
|---|---|
| Fetch by ID | Retrieves all associated files by using a model's unique numeric ID. |
| Detailed File Information | Provides comprehensive data for each file, including its name, direct download URL, size in bytes, and file type. |
Description Retrieval
This feature fetches the description content directly from a model's web page.
| Sub-Feature | Description |
|---|---|
| Fetch by URL | Get the full description from a model's page using its complete URL. |
| Markdown Formatting | Returns the extracted description text in markdown format for proper rendering and readability. |
Getting Started
Prerequisites
- Python 3.8+
- pip
Installation
-
Clone the repository to your local machine.
git clone https://github.com/GhostTypes/printables-mcp-server.git -
Navigate to the cloned repository's directory.
cd printables-mcp-server -
Install the required Python dependencies.
pip install -r requirements.txt -
Add to your desired MCP client (example for VSCode)
"printables-mcp": { "type": "stdio", "command": "python", "args": [ "path/to/printables_mcp_server.py" ] }