Printables

printables-mcp

English · Русский

Printables.com 向けの MCP サーバーです。AI エージェントが3Dモデルを検索し、モデルカードを読み、ファイルを一覧表示して、直接ダウンロードリンクを取得できます。

公開されている Printables GraphQL API に直接アクセスします。HTML スクレイピングもブラウザーもアカウントも不要です。すべてのツールは読み取り専用で、構造化された結果（出力スキーマ付きの JSON）を返すため、エージェントは文章ではなく正確なフィールドを取得できます。

インストール

uv tool install printables-mcp

次に、printables-mcp コマンドを 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	1回のリクエストですべてのファイルグループを取得：モデルファイル（STL/3MF/STEP…）、プリンター、素材、レイヤー高、ノズル、プリント時間を含むG-code、SLAファイル、その他のファイル、ZIPパック。
get_download_links	すべてのファイルまたは選択したファイルの直接ダウンロードURL（有効期間24時間）を並列で取得します。有料モデルまたはクラブ限定モデルのファイルは、呼び出しを失敗させる代わりに、ファイルごとの理由を返します。
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

ライセンス

MIT