b123d-print

b123d-print

3D プリントのためのバイブ CAD。 必要なものを、写真とノギスで測った数値をいくつか添えて、普段の言葉で AI アシスタントに伝えるだけです。パーツを設計し、あらゆる角度から確認して、プリント上の問題をチェックし、スライサー用のファイルを作成します。CAD のスキルは不要です。MCP に対応するあらゆるアシスタントで動作します。Claude、Gemini CLI、Cursor、VS Code Copilot、Codex、そしてその他（対応クライアントと、それぞれの接続方法）に対応しています。

作成できるもの

ノギスとCADソフトを持っている友人に頼むように、気軽に相談してください。次のように設計し、印刷できます。

• 「このIRブラスター基板用のケースを作ってください。LEDは上から外に向けて、ねじ止め式の蓋を付け、壁に取り付けるタブを2つ付けてください。」 基板の代わりとなるモデルに合わせて確認した、2パーツ構成のケースです。
• 「この人感センサー用の屋外ケースを作ってください。壁面プレートからスライドして外せて、雨が入らないようにしてください。」 ダブテールレール、はめ込み式の止め機構、排水溝、サポートなしで印刷できるカバーを備えています。
• 「変換プレートを作ってください。裏側には2連ボックス、手前には1連のスマートスイッチです。」 皿もみ穴を付け、最初の印刷で0.05 mmの薄い部分を貫通してしまった後に、壁の確認も追加しました。レンダリングでは気付けなかった問題です。

また、ダウンロードしたモデル（STL、3MF、またはSTEP）をリミックスして、変更することもできます。

• 「ダウンロードしたL字ブラケットのSTLです。2つの取り付け穴を長穴にして、ガセットを追加してください。」 元のモデルをソリッドとして読み込み、変更します。検査では元のモデルの問題と新たな問題を見分けられ、変更前後の表示でどこが変わったかを正確に確認できます。（ドキュメント用のデモで、まだ印刷していません。）

長時間の印刷を行う前に、実際のパーツから切り出した薄くて短時間で印刷できるフィットテスト用テンプレートで、はめあいを確認できます。

• 「穴の配置を確認できるよう、取り付け面のフィットテスト用テンプレートを作ってください。」 アシスタントが面を赤く表示して確認を求め、パーツとまったく同じ穴を備えた1.2 mmのプレートを作成します。何時間もかける代わりに、数分で印刷できます。

大きいもの、曲面のもの、測りにくいものを測定する場合は、AI 用の測定方法で、使うツールやスケールを添えて撮影する方法、そして曖昧さなく数値を伝えるためのコピー＆ペースト用測定シートとオフセット表（基準線に沿った測定位置）を確認できます。

スペーサー、ノブ、ブラケット、ケーブルクリップ、測定できる壊れたパーツの交換品など、日常的に使うものも作れます。そのままやり取りを続けて、「高さを5 mm増やして」「M4ねじ用の穴を開けて」「蓋がきつすぎます」と伝えてください。すべての寸法は短いbuild123dスクリプト内で名前付きの数値として保持されるため、変更は正確です。また、必要に応じてほかのCADで編集を続けられるSTEPファイルも入手できます。

IRトランシーバー基板用の2パーツ構成ケース。基板の代わりとなるモデルを組み込んだ状態	LEDを通る断面：蓋の円錐部、基板、クリアランス
屋外用センサーケース：ダブテール式背面プレート＋サポート不要のカバー	壁面プレート：壁の確認箇所が分かる、表面のすぐ奥の断面
リミックス：ダウンロードしたブラケットの変更前と変更後	リミックスによる変更箇所：赤が削除部分、灰色が追加部分

ドキュメント：https://kd5ryn.github.io/b123d-print/

2 分で始める

b123d-print の MCP サーバーは、AI アシスタントに CAD ツールを追加するプラグインです。お使いのコンピューター上で動作します。

簡単な方法： 次の内容を AI アシスタント（Claude Code、Claude Desktop、Cursor、Gemini CLI、Codex など）に貼り付けます。

Install the b123d-print MCP server for me. It runs with
`uvx --from b123d-print b123d-print-mcp --workspace <folder>`
where <folder> is a folder for my parts, such as ~/parts.
Install uv first if it is missing (https://docs.astral.sh/uv/).
Add the server to your MCP settings, tell me when to restart you,
and after the restart check that its tools (list_parts, new_part,
build_part, ...) are available.

いくつかのコマンド（uv のインストールとサーバーの追加）を実行するか確認されることがありますが、これは想定どおりです。

手動で行う場合：

1. uv をインストールします。uv が Python と、b123d-print に必要なその他すべてを取得します。

2. サーバーを追加します。Claude Code の場合：

   claude mcp add b123d-print -- uvx --from b123d-print b123d-print-mcp --workspace ~/parts
   

   または、Claude Code プラグイン（サーバーとスキル）を一度にインストールします：

   /plugin install b123d-print --marketplace KD5RYN/b123d-print
   

   Claude Desktop の場合（Settings → Developer → Edit Config）：

   {
     "mcpServers": {
       "b123d-print": {
         "command": "uvx",
         "args": ["--from", "b123d-print", "b123d-print-mcp", "--workspace", "/Users/you/parts"]
       }
     }
   }
   

   Cursor、VS Code、Gemini CLI、Codex などの場合：MCP クライアントを接続する。

3. アシスタントを再起動します。

プリンターを設定する： 「自分のプリンター用に b123d-print をセットアップして」 と頼みます（setup_workspace プロンプト。ターミナルでは b123d-print setup）。プリンター、材料、エクスポート形式、スタイルを設定し、続いてキャリブレーション用クーポンを作成します。

次に頼むこと： 「直径 40 mm、高さ 10 mm の丸いスペーサーを、M3 の穴付きで設計して」 と頼みます。ファイルはパーツフォルダーの parts/<name>/out/ に保存され、スライサー用のファイルは out/print/ にあります（保存するファイル）。初回起動時には数百 MB をダウンロードするため、数分かかることがあります（トラブルシューティング）。アシスタントはレンダリングを確認して作業を検証するため、ツールの画像をモデルに渡せるクライアントを使用してください（Claude Desktop と Claude Code は対応しています）。

一連の作業を通して学ぶ： インストールから印刷までを扱う最初のパーツ、棚受けと、ダウンロードした STL をリミックスする方法をご覧ください。

対象範囲：FDM 3D プリント用のパーツに限ります。それ以外は対象外です。 印刷するパーツを中心にすべてが構成されています。ベッドを Z=0 とする印刷方向、穴の補正、嵌合クリアランス、キャリブレーション用クーポン、そして出典のある FDM 設計ルールに基づく印刷チェックが含まれます。汎用 CAD フレームワークではありません。

含まれる内容

• b123d-print パッケージと CLI — エクスポート、6 方向からのレンダリング、色分けされた複数パーツの断面表示、プリントチェックに対応します。プリント時の嵌合パーツ間の重なり、向きに応じたオーバーハングとブリッジ、切り欠き周辺の薄い形状と壁厚、たわみやすい丸い天面の穴、ベッド端のフィレット、可動パーツ間の隙間、および「屋根は閉じているか？」などを確認するプローブを利用できます。
• b123d-print-mcp — MCP サーバーです。Claude Desktop、Claude Code、Gemini CLI、Cursor、VS Code、Codex などの MCP クライアントから利用できます。パーツのスクリプトはモデルが作成したコードで、タイムアウトとネットワーク接続なしのサンドボックス内で実行されます。
• compare — パーツを参照用の STL、3MF、または STEP と比較します。サイズ、体積、表面の差分、0～100 のスコア、合否、および偏差ビューを確認できます（パーツの比較）。
• リミックス — 他の人が作成した STL、3MF、または STEP から始められます。import_model はメッシュをソリッドに変換し（同一平面上の三角形は結合されます）、チェックによって元のモデルの問題とリミックスで追加された問題を区別できます。また、変更をビフォー／アフター表示で確認できます（パーツのリミックス）。
• 複製 — 成形品などの物理パーツを複製します。寸法ごとの測定計画、各寸法が重要か自由に決められるかの指定、FDM 向けに変更した成形形状とその理由、および MEASURE.md の測定値とモデルを照合する replication_spec に対応します（物理パーツの複製）。
• フィットテスト用テンプレート — 実際のパーツの面、スライス、または領域を薄くすばやくプリントします（穴とクリアランスは同じです）。本番のプリント前に、穴のパターンとフィットを確認できます（フィットテスト用テンプレート）。
• 設計レビュー — プリントチェックに合格した後、選択したスタイル（機能性、モダン、低コスト、堅牢／屋外向け、柔らかい／手持ち向け、構造／荷重支持、有機的／自然、装飾／花瓶、おもちゃ／子ども向け安全性）に合わせて、アシスタントがパーツをレビューします。フィラメントと所要時間の概算、サポート材、エッジ処理、積層段差、水がたまる箇所、内側の角と壁、おもちゃの小さなパーツについて確認し、出典付きの設計ルールに基づく具体的な提案を行います。承認なしに変更を加えることはありません（設計レビュー）。
• モデルに依存しないワークフロー — MCP プロンプトに加え、どのエージェントでも読み取れる AGENTS.md を用意しています。ルールは実際のプリントから得たもので、レンダリングでは確認できなかった 0.05 mm の薄い部分を貫通してパーツが壊れたことをきっかけに追加されたルールもあります。
• サンプル — この方法で設計してプリントした 4 つのパーツに加え、穴、フィット、オーバーハング、ブリッジ用のキャリブレーション用クーポンを src/b123d_print/examples/ に収録しています。

上級者向け：別のマシンで実行する

多くの方には必要ありません。パーツを自宅のサーバーに置き、ノート PC から設計する場合はSSHを使用してください。多数のエージェントで 1 台のサーバーを共有する場合（評価実行やチーム利用）は、ツールごとに個別のトークンを設定したHTTPを使用してください。最も強い分離が必要な場合（Windows でも利用可能）は、Dockerを使用してください。 どの方式を選ぶべきか？で各方式を比較しています。

ドキュメント

まずはこちら	チュートリアル：初めてのパーツ · チュートリアル：ダウンロードしたSTLをリミックスする
はじめに	クイックスタート · MCP クライアント（Claude Desktop、Claude Code、claude.ai、ChatGPT、Gemini CLI、Antigravity、OpenCode、Qwen Code、pi、Cursor、VS Code、Codex、Grok、Windsurf、Zed、LM Studio） · CLI と Python
応用	どのモードを選ぶか · SSH 経由のリモート接続 · ネットワーク経由（HTTP） · Docker
使い方	セッションの流れ · AI のための測定 · MCP ツールとプロンプト · 出力形式 · パーツからプリントまで · 設定 · 穴の補正 · プリンタープロファイル · チェック項目 · サンドボックス · パーツの比較 · パーツのリミックス · 実物パーツの複製 · フィットテスト用テンプレート
パーツスクリプト	パーツスクリプト · Checks API · 例 · ワークフロールール · 設計ルール（出典付き）
その他	よくある質問 · リファレンス · 更新 · トラブルシューティング · コントリビューション · エージェント評価 · クレジットとライセンス

ステータス

0.x — 初期段階です。 パーツスクリプトの規約は今後変更される可能性があります。CI では、macOS、Ubuntu、Windows、uvx 経由でビルドしたパッケージ、および Docker イメージを、プッシュのたびにテストします。Windows ではローカル利用時にサーバーがネイティブで動作しますが、OS サンドボックスはありません（プロセス分離と監査フックのみです）。分離が必要な場合は、WSL2 または Docker を使用してください。SSH モードのサーバー側は macOS と Linux のみ対応しています。Windows は SSH または HTTP のクライアントとして使用できます。プラットフォームとステータス。

クレジットとライセンス

b123d-print は、build123d、 Open CASCADE Technology（OCP 経由）、 lib3mf、OrcaSlicer の プリンターのデータ、パーツスクリプト用の bd_warehouse と py_gearworks、 matplotlib、NumPy、 MCP Python SDK、uv の上に構築された薄いレイヤーです。 詳細と再配布に関する注意事項：THIRD_PARTY.md。

MIT © KD5RYN およびコントリビューター。