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 分