3D模型搜索服务器

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
   

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

   复制

   cd printables-mcp-server
   

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

   复制

   pip install -r requirements.txt
   

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

   复制

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