Printables MCP Server

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

先决条件

• Python 3.8+
• 点

______________________________________________________________________

Installation

1. 将存储库克隆到本地计算机。

   git clone https://github.com/GhostTypes/printables-mcp-server.git

1. 导航到克隆存储库的目录。

   cd printables-mcp-server

1. 安装所需的Python依赖项。

   pip install -r requirements.txt

1. 添加到所需的MCP客户端（VSCode示例）

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