Printables

io.github.feodor-ra由 GitHub 帳號 feodor-ra 發布v0.1.1更新於 Nov 3, 2026

Search Printables.com 3D models, read model cards, list files and get download links.

已驗證STDIO僅桌面檔案與儲存媒體與設計

概覽

AI 產生的概覽

讓 AI 助理搜尋 Printables.com 上的 3D 列印模型、讀取模型資訊、列出檔案並取得直接下載連結。

可以做什麼
  • 以文字搜尋模型，可依分類、價格、授權、發佈時間與列印次數篩選，並支援排序與分頁
  • 讀取模型完整資訊：描述、標籤、分類、授權、列印參數、圖片與二次創作來源
  • 列出模型的全部檔案，包含附印表機、材料與切片參數的 G-code
  • 取得模型檔案的直接下載連結，有效期 24 小時
  • 列出分類與授權，以取得搜尋篩選所需的 ID
  • 讀取作者公開資料，並分頁瀏覽其發佈的模型
適用情境
適合讓助理尋找可 3D 列印的模型、比較列印設定與授權，或為準備列印的模型取得檔案。偏向自造者與愛好者情境，而非一般網頁搜尋。
執行需求
以本機 stdio 程序執行，需用 uv tool install 安裝或以 uvx 直接執行，因此需要 Python/uv 環境。無需帳號、API 金鑰或環境變數，但需連網存取公開的 Printables GraphQL API。
安裝前請注意
僅支援匿名存取：付費或 Printables Club 模型的檔案無法下載，但模型本身可見。所用 API 未公開文件，可能隨時變更。下載連結 24 小時後失效；此伺服器的工具皆為唯讀。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Printables，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

printables-mcp

English · Русский

[PyPI - Version] [PyPI - Python Version] [PyPI - Status] [CI]

[MCP Registry] [feodor-ra/printables-mcp MCP server]

An MCP server for Printables.com: lets an AI agent search 3D models, read model cards, list files and get direct download links.

It talks to the public Printables GraphQL API directly: no HTML scraping, no browser, no account. All tools are read-only and return structured results (JSON with an output schema), so agents get exact fields instead of prose.

Installation

bash
uv tool install printables-mcp

Then register the printables-mcp command with your MCP client. Claude Code:

bash
claude mcp add printables -s user -- printables-mcp

Any other client that speaks stdio:

json
{  "mcpServers": {    "printables": { "command": "printables-mcp" }  }}

Without installing: uvx printables-mcp.

Tools

ToolWhat it does
search_modelsText search with pagination (limit, offset, total count) and filters: category, price (free / paid), licenses, published within N days, has user prints. Orderings: best match, popular, latest, rating, makes count.
get_modelFull model card: description as Markdown, tags, category path, license, materials, printer, print time, filament weight, images, PDF, remix sources, stats, price.
list_model_filesEvery file group in one request: model files (STL/3MF/STEP…), G-code with printer, material, layer height, nozzle and print time, SLA files, other files, ZIP packs.
get_download_linksDirect download URLs (valid 24 h) for all or selected files, fetched in parallel. Files of paid or club-only models come back with a per-file reason instead of failing the call.
list_categoriesAll categories with their full paths (IDs for the search filter).
list_licensesAll licenses (IDs for the search filter).
get_authorAuthor profile by ID, handle or profile URL.
list_author_modelsAn author's models, cursor-paginated, ordered by newest, oldest, likes, downloads, rating or makes.

Models and authors can be passed as IDs or as printables.com URLs (locale prefixes such as /de/ are fine).

Limitations

  • Anonymous access only: paid and Printables Club models are visible, but their files cannot be downloaded.
  • The API is undocumented and may change without notice; the end-to-end suite (just test-live) checks it against the live service.

Development

bash
uv syncjust lint       # ruff format/check + tyjust test       # pytest with 100% branch coveragejust test-live  # end-to-end tests against the real API

License

MIT

來源：README.md，提交 9923c8d

工具

8

search_models

Search Printables models by text with optional filters and pagination. Returns: The total match count and one page of model summaries.

輸入參數limitpricequery必填offsetorderinghas_makescategory_idlicense_idspublished_within_days

get_model

Get a model's full card: Markdown description, tags, category, license, print parameters, images, remixes. Returns: The model details.

輸入參數model必填

list_model_files

List every downloadable file of a model with sizes and, for G-code, printer/material/slicing parameters. Use `get_download_links` to obtain the actual URLs. Returns: All files of the model.

輸入參數model必填

list_categories

List all model categories with their full paths; the IDs feed `search_models(category_id=...)`. Returns: All categories.

無需輸入參數。

list_licenses

List the licenses models are published under; the IDs feed `search_models(license_ids=...)`. Returns: All licenses.

無需輸入參數。

get_author

Get an author's public profile. Returns: The profile.

輸入參數author必填

list_author_models

List models published by an author, page by page. Returns: One page of the author's models and the cursor for the next one.

輸入參數limitauthor必填cursorordering

版本歷史

1
  1. v0.1.1最新Nov 1, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分