printables-mcp-server

GhostTypes/printables-mcp-server

3.2

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

FeatureDescription
Model SearchSearch for models with rich metadata.
File RetrievalGet all downloadable files associated with a specific model ID.
Description ScrapingFetches 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-FeatureDescription
Search by TermFinds models using a specific query string (e.g., "benchy", "vase").
Result LimitingControls the maximum number of search results returned in a single query.
Detailed MetadataReturns 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-FeatureDescription
Fetch by IDRetrieves all associated files by using a model's unique numeric ID.
Detailed File InformationProvides 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-FeatureDescription
Fetch by URLGet the full description from a model's page using its complete URL.
Markdown FormattingReturns the extracted description text in markdown format for proper rendering and readability.

Getting Started

Prerequisites

  • Python 3.8+
  • pip

Installation

  1. Clone the repository to your local machine.

    git clone https://github.com/GhostTypes/printables-mcp-server.git
    
  2. Navigate to the cloned repository's directory.

    cd printables-mcp-server
    
  3. Install the required Python dependencies.

    pip install -r requirements.txt
    
  4. Add to your desired MCP client (example for VSCode)

    "printables-mcp": {
    	"type": "stdio",
    	"command": "python",
    	"args": [
    		"path/to/printables_mcp_server.py"
    	]
    }