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 henry@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"
		]
	}