Printables

Name: Printables
Author: feodor-ra

本地服务

github.com/feodor-ra搜索与检索16 天前更新

代码仓库

关于 Printables

printables-mcp 是只读 MCP 服务，用于搜索 Printables.com 上的 3D 模型，并获取模型、作者、文件和下载信息。它直接调用公开的 GraphQL API，以结构化结果返回数据，无需浏览器或账户。

主要功能

01按条件和分页搜索模型
02获取模型卡片及文件详情
03获取可用文件的直接下载链接
04浏览分类、许可证和作者模型
05查询作者资料

适用场景

01按分类、价格、许可证或热度查找模型
02查看模型材料、打印设置和文件
03获取可访问模型文件的下载链接

MCP 相关

通过 stdio 向 MCP 客户端提供只读的 Printables.com 搜索和模型数据工具。匿名访问可查看付费及 Printables Club 模型，但无法下载其文件。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "feodor-ra-printables": {
      "command": "uvx",
      "args": [
        "printables-mcp"
      ]
    }
  }
}

启动命令uvx printables-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiprintables-mcp0.1.1stdio

工具

收录的工具列表 · 更新于 6 天前

参数	类型	必填	说明
limit	integer	否
price	enum	否	paid 包含仅限 club 的模型all \| free \| paid
query	string	是	搜索文本；空字符串表示列出所有内容
offset	integer	否	跳过指定数量的结果（分页）
ordering	enum	否	best_match \| popular \| latest \| rating \| makes_count
has_makes	any	否	仅包含有用户发布打印作品的模型
category_id	any	否	来自 `list_categories` 的类别 ID
license_ids	any	否	来自 `list_licenses` 的许可证 ID
published_within_days	any	否

详细介绍

printables-mcp

English · Русский

PyPI - Python Version PyPI - Status

一个适用于 Printables.com 的 MCP 服务：让 AI Agent 搜索 3D 模型、阅读模型卡片、列出文件并获取直接下载链接。

它直接调用 Printables 的公共 GraphQL API：不抓取 HTML、不使用浏览器，也无需账户。所有工具均为只读，并返回结构化结果（带有输出架构的 JSON），让 Agent 获取精确字段，而非散文。

安装

uv tool install printables-mcp

然后在 MCP 客户端中注册 printables-mcp 命令。Claude Code：

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

其他任何使用 stdio 通信的客户端：

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

无需安装：uvx printables-mcp。

工具

工具	功能
`search_models`	文本搜索，支持分页（`limit`、`offset`、总数）和筛选：类别、价格（`free` / `paid`）、许可证、在 N 天内发布、是否有用户打印件。排序方式：最佳匹配、热门、最新、评分、打印次数。
`get_model`	完整的模型卡片：Markdown 格式的描述、标签、类别路径、许可证、材料、打印机、打印时间、耗材重量、图片、PDF、混录来源、统计数据、价格。
`list_model_files`	一次请求列出所有文件组：模型文件（STL/3MF/STEP…）、含打印机、材料、层高、喷嘴和打印时间的 G-code、SLA 文件、其他文件、ZIP 包。
`get_download_links`	获取所有或所选文件的直接下载 URL（有效期 24 h），并行获取。对于付费模型或仅限会员的模型，文件会返回逐文件原因，而不会导致调用失败。
`list_categories`	所有类别及其完整路径（供搜索筛选器使用的 ID）。
`list_licenses`	所有许可证（供搜索筛选器使用的 ID）。
`get_author`	按 ID、用户名或个人资料 URL 获取作者资料。
`list_author_models`	作者的模型，使用游标分页，可按最新、最早、点赞数、下载数、评分或打印次数排序。

模型和作者可以通过 ID 或 printables.com URL 传入（/de/ 等语言前缀也可以）。

限制

仅支持匿名访问：可以查看付费模型和 Printables Club 模型，但无法下载其文件。
该 API 没有文档说明，可能会在不另行通知的情况下发生变化；端到端测试套件（just test-live）会针对在线服务进行检查。

开发

uv sync
just lint       # ruff format/check + ty
just test       # pytest with 100% branch coverage
just test-live  # end-to-end tests against the real API