MCP 3D Printer Server

STL 操作ツール

すべての STL ツールは、メッシュ全体をメモリに読み込みます。モデルを変更するツールは、入力ファイル名に _scaled のような接尾辞を付けてサーバーの一時ディレクトリに新しいファイルを書き込み、そのパスを返します。入力ファイルは変更されません。

get_stl_info

STL ファイルを変更せずに検査します。バウンディングボックス、寸法、中心、頂点数、面数を返します。

{
  "stl_path": "/path/to/model.stl"
}

scale_stl

scale_factor でモデルを一様に拡大・縮小するか、scale_x、scale_y、scale_z で軸ごとに拡大・縮小します。いずれかの軸の値を指定した場合、指定されていない軸は 1.0 のままになります。

{
  "stl_path": "/path/to/model.stl",
  "scale_factor": 1.2
}

{
  "stl_path": "/path/to/model.stl",
  "scale_x": 1.2,
  "scale_y": 1.0,
  "scale_z": 1.5
}

rotate_stl

モデルを X、Y、Z 軸を中心に度単位で回転します。省略した軸は 0 がデフォルトです。

{
  "stl_path": "/path/to/model.stl",
  "rotate_x": 0,
  "rotate_y": 0,
  "rotate_z": 90
}

translate_stl

モデルを X、Y、Z 軸に沿ってミリメートル単位で移動します。省略した軸は 0 がデフォルトです。

{
  "stl_path": "/path/to/model.stl",
  "translate_x": 10,
  "translate_y": 5,
  "translate_z": 0
}

extend_stl_base

モデルの下にソリッドジオメトリを追加して、ベースを高く、広くします。extension_inches はインチ単位で、ミリメートルに変換されます（1 インチあたり 25.4 mm）。

{
  "stl_path": "/path/to/model.stl",
  "extension_inches": 0.25
}

merge_vertices

tolerance（ミリメートル単位、デフォルト 0.01）より近い頂点を結合します。これにより、小さな隙間をふさいでメッシュをわずかに簡略化できます。

{
  "stl_path": "/path/to/model.stl",
  "tolerance": 0.01
}

center_model

モデルを移動し、バウンディングボックスの中心が原点（0, 0, 0）に来るようにします。

{
  "stl_path": "/path/to/model.stl"
}

lay_flat

モデルの最大の平面を見つけ、その面が XY 平面（Z = 0）に接するようにモデルを回転します。明確に突出した平面があるモデルで最も効果を発揮します。

{
  "stl_path": "/path/to/model.stl"
}

modify_stl_section

モデルの一部分（バウンディングボックスを 3 等分した top、bottom、center のいずれか、または custom ボックス）に、拡大縮小、回転、平行移動を適用します。value_x、value_y、value_z は、transformation_type に応じて倍率、度数、またはミリメートル単位の値になります。

{
  "stl_path": "/path/to/model.stl",
  "section": "top",
  "transformation_type": "scale",
  "value_x": 1.5,
  "value_y": 1.5,
  "value_z": 1.5
}

custom セクションでは、6 つすべての境界値が必要です。

{
  "stl_path": "/path/to/model.stl",
  "section": "custom",
  "transformation_type": "rotate",
  "value_x": 0,
  "value_y": 0,
  "value_z": 45,
  "custom_min_x": -10,
  "custom_min_y": 0,
  "custom_min_z": -10,
  "custom_max_x": 10,
  "custom_max_y": 20,
  "custom_max_z": 10
}

generate_stl_visualization

モデルの正面、側面、上面、アイソメトリックビューを含む SVG をレンダリングします。width と height で各ビューのサイズをピクセル単位で指定します（デフォルトは 300）。

{
  "stl_path": "/path/to/model.stl",
  "width": 400,
  "height": 400
}

SVG は簡略化した模式図であり、フォトリアリスティックなレンダリングではありません。

プリンター制御ツール

すべてのプリンターツールで host、port、type、api_key を指定できます。また、Bambu プリンターでは bambu_serial と bambu_token も使用します。省略した値には、PRINTER_HOST、PRINTER_PORT、PRINTER_TYPE、API_KEY、BAMBU_SERIAL、BAMBU_TOKEN が使用されます。キーは呼び出し時に渡さず、サーバー設定に保持してください。

各呼び出しの動作はバックエンドによって異なります。正確な API ルートについては、プリンターバックエンドのセットアップを参照してください。

すべてのバックエンドで、印刷の開始と正の加熱コマンドは必ず安全ゲートを通過します。サーバーは実行を開始する正確な G-code を検査し、各ヒーターの目標温度がハードウェアと材料の上限を超えていないか確認し、プリンターが使用可能な状態であることを確かめたうえで、MCP elicitation を通じて人間に確認を求めます。ヒーターをオフにする操作（temperature: 0）と cancel_print は安全ゲートの対象外です。

get_printer_status

プリンターの現在の状態を読み取ります。応答にはバックエンド固有の状態データが含まれます。Bambu では温度、ジョブの状態、進捗、レイヤー数、残り時間、AMS データが返され、OctoPrint ではプリンターの状態と温度が返されます。Klipper では Moonraker ホストの状態のみが返されます。

{
  "type": "klipper",
  "host": "192.168.1.50",
  "port": "7125"
}

list_printer_files

プリンターまたはそのホストソフトウェアに保存されているファイルを一覧表示します。Bambu プリンターでは、cache/、timelapse/、logs/ ディレクトリが一覧表示されます。

{
  "type": "octoprint",
  "host": "192.168.1.100"
}

G-code をプリンターにアップロードし、必要に応じて印刷を開始します。ローカルファイルには gcode_path を、内容（またはローカルパス）には gcode を渡します。filename のデフォルトは gcode_path のベース名です。印刷する場合は、開始されるファイルがアップロードしたものと完全に一致するよう、通常のファイル名を使用してください。

{
  "type": "klipper",
  "host": "192.168.1.50",
  "port": "7125",
  "gcode_path": "/path/to/benchy.gcode",
  "print": true,
  "material": "PETG"
}

• print を指定しない場合、ファイルはアップロードされるだけで、内容の検査や印刷の開始は行われません。
• print: true を指定すると、アップロードしたバイト列そのものを先に検査し（すべての S および R のヒーター目標値、ツールの変更、ハードウェアと素材の上限を確認します）、プリンターの状態を確認したうえで、印刷開始前に人間の確認を求めます。
• 印刷には素材の指定が必要です。ファイル内のスライサーメタデータ（; filament_type = PLA）または material 引数で指定してください。ファイルの内容と矛盾する指定はできません。
• Bambu プリンターでは、ファイルは FTPS 経由で cache/ に送信されます。印刷にはモデル（bambu_model または BAMBU_MODEL）も必要です。アップロード後の自動印刷に対応しているのは .gcode のみです。.3mf プロジェクトを印刷するには print_3mf を使用してください。

start_print

プリンターにすでに保存されている G-code ファイルの印刷を開始します。サーバーはそのファイルをダウンロードして検査し、プリンターの状態を確認して人間の確認を求めた後、検査済みの一意な名前のコピーを開始します。Bambu Lab、OctoPrint、Klipper（Moonraker）、Duet で動作します。Repetier、Prusa、Creality は検証済みのダウンロード方法がアダプターにないため、要求を拒否します。代わりに print: true を指定して upload_gcode を使用してください。

{
  "type": "octoprint",
  "host": "192.168.1.100",
  "filename": "benchy.gcode",
  "material": "PLA"
}

ファイルに filament_type メタデータがない場合は、material を渡してください。Bambu プリンターではモデルも必要です。また、対応しているのは .gcode ファイルのみです。ファイル名だけを指定した場合は、cache/ 内を検索します。

cancel_print

現在の印刷ジョブをキャンセルします。キャンセルに確認は不要で、開始待ちの検査済み印刷もキャンセルされます。一時停止または再開のツールはありません。キャンセルした印刷は再開できません。

{
  "type": "prusa",
  "host": "192.168.1.120"
}

set_printer_temperature

プリンターのコンポーネントの目標温度を設定します。bed または extruder を指定してください。Bambu では nozzle、tool、tool0 も指定できます。OctoPrint のノズル目標温度は tool0 に送信されます。

{
  "type": "klipper",
  "host": "192.168.1.50",
  "port": "7125",
  "component": "extruder",
  "temperature": 215,
  "material": "PLA"
}

• temperature は 0 以上の有限数である必要があります。0 を指定するとヒーターがオフになり、確認は不要です。
• 0 より大きい目標温度は、接続前に独立したハードウェア上限と素材の上限に照らして確認されます。プリンターが準備完了状態である必要があり、人間の確認も求められます。
• 0 より大きいノズル加熱には、RFID のないスプールを含め、material（例：PLA、PETG、ABS）の指定が必要です。
• Bambu プリンターで 0 より大きい温度に加熱する場合は、bambu_model（または BAMBU_MODEL）も必要です。ノズルを加熱する場合は nozzle_diameter（0.2、0.4、0.6、0.8。デフォルトは NOZZLE_DIAMETER、または 0.4）を使用します。どちらもプリンターの現在の状態に照らして確認されます。

Bambu 専用ツール

これらのツールは PRINTER_TYPE=bambu（または type: "bambu"）で動作します。Bambu Lab のセットアップの説明に従って、LAN Only Mode、シリアル番号、アクセスコード、モデルを設定してください。

print_3mf

スライス済みの .3mf プロジェクトを FTPS 経由で Bambu プリンターにアップロードし、プレートの G-code パス、その MD5、AMS マッピング、キャリブレーションフラグを含む MQTT project_file コマンドで印刷を開始します。bambu_model は必須です（または BAMBU_MODEL）。これが指定されていない場合、クライアントが対応していればサーバーが MCP エリシテーションで確認し、対応していなければエラーを返します。モデルを間違えると、ベッドがノズルに衝突するおそれがあります。

アップロード前に、サーバーは選択したプレートのプライベートコピーを検査します（モデル、ノズル、ベッドタイプ、材料、すべてのヒーター目標値）。これらをモデルごとのハードウェア上限、材料の上限値、そしてプリンターのモデル、シリアル番号、ノズル、状態、エラー、装填済みフィラメントを含む最新の MQTT レポートと照合します。その後、人による確認を行い、ディスパッチ前にレポートを再度確認します。

{
  "three_mf_path": "/path/to/bracket.gcode.3mf",
  "bambu_model": "p1s",
  "bed_type": "textured_plate",
  "use_ams": true,
  "ams_mapping": { "Generic PLA": 0 },
  "bed_leveling": true,
  "flow_calibration": true,
  "vibration_calibration": true,
  "layer_inspect": true,
  "timelapse": false
}

• プロジェクトにプレートの G-code が含まれていない場合、サーバーは FULU OrcaSlicer-bambulab または Bambu Studio で自動スライスを試みます。スライスに失敗した場合、または選択したプレートに G-code がない場合、エラーで停止し、元のプロジェクトはアップロードされません。
• ams_mapping は、値が AMS スロット番号であるオブジェクトです。省略した場合は、3MF に埋め込まれたマッピングが使用されます。マッピングがない場合、印刷は AMS を使わずに実行されます。use_ams: false は AMS を無効にします。
• コマンドを送信した後、サーバーは最新のレポートを最大 15 秒間監視し（BAMBU_DISPATCH_CHECK_MS）、dispatch: "started" または "unconfirmed" を返します。ファームウェアがコマンドを拒否した場合（Developer Mode が無効でファームウェア 01.08.05 以降を使用している場合の HMS 0500-0500-0001-0007）、呼び出しは失敗し、その旨が通知されます。検証済みのファイルはプリンターのストレージに残ります。
• nozzle_type（stainless_steel、hardened_steel、tungsten_carbide、brass）は、プロジェクトを自動スライスする必要がある場合に、取り付けられているノズルを設定します。ジョブのノズルタイプは、プリンターのレポートと一致している必要があります。
• bed_type は textured_plate、cool_plate、engineering_plate、hot_plate のいずれかです（デフォルトは BED_TYPE、それ以外の場合は textured_plate）。プレートのベッドメタデータと一致する必要があります。そのため、別のプレート用にスライスされたファイルや、ベッドメタデータがないファイルは、bed_type が一致するまで拒否されます。
• nozzle_diameter は 0.2、0.4、0.6、0.8 を受け付けます（デフォルトは NOZZLE_DIAMETER、それ以外の場合は 0.4）。
• 省略した場合、キャリブレーションフラグはオン、タイムラプスはオフがデフォルトです。
• layer_height、nozzle_temperature、bed_temperature、support_enabled は受け付けられますが、適用されません。これらの設定はスライス済みファイルに組み込まれています。スライサーで変更してください。
• 成功応答は、コマンドが送信されたことを示すものであり、印刷が問題なく開始されたことを示すものではありません。プリンターの状態を確認してください。

check_fulu_orca_setup

FULU OrcaSlicer-bambulab のインストール状況を検査します。実行ファイル、プラットフォームランタイムのペイロード、インストールおよび検証コマンドを確認し、オプションで BambuNetwork ブリッジのハンドシェイクも検証します。パスのデフォルト値はサーバー環境に基づきます。詳しくはセットアップの確認を参照してください。

{
  "platform": "darwin",
  "run_bridge_probe": true
}

bridge_command、および run_bridge_probe: true を指定した場合の slicer_path、plugin_dir、runtime_dir には、MCP_ALLOW_EXECUTABLE_ARG=1 が必要です。

fulu_bambu_network_rpc

診断のために、FULU BambuNetwork のブリッジメソッドを 1 つ呼び出します。bridge.handshake、bridge.runtime_info、net.get_user_print_info などの読み取り専用メソッドは、デフォルトで許可されています。エージェントとセッションのセットアップメソッドを実行するには、allow_mutating_method: true が必要です。生の印刷メソッド（net.start_print など）、プリンターのメッセージ（net.send_message）、ファイル転送、未知のメソッドは、印刷の安全ゲートを迂回することになるため拒否されます。印刷には print_3mf を使用してください。bambu_model は情報提供のみを目的としています。ブリッジ RPCを参照してください。

{
  "method": "bridge.handshake"
}

ブリッジコマンドは FULU_BAMBU_BRIDGE_COMMAND から取得されます。呼び出しごとに bridge_command を指定するには、MCP_ALLOW_EXECUTABLE_ARG=1 が必要です。

スライスツール

スライサーの種類、プロファイル、トラブルシューティングについては、スライスガイドを参照してください。スライサーの GUI で自分でファイルをスライスし、その結果をアップロードする方法が最も確実です。

slice_stl

設定されたスライサーでSTLまたは3MFをスライスし、出力パスを返します。PrusaSlicer、Slic3r、汎用OrcaSlicer、CuraEngineではG-codeを、Bambu互換パスではスライス済みの.3mfを返します。

Bambu互換パスは、Bambu Studio、FULU OrcaSlicer-bambulab、および呼び出しでbambu_modelを渡した場合のOrcaSlicerで使用されます。

• マシンプリセットは常にbambu_model（未指定の場合はBAMBU_MODEL。未設定なら入力を求めます）とnozzle_diameter（デフォルトはNOZZLE_DIAMETERまたは0.4）から決まります。選択したスライサーのインストール環境に、正確な<model> <diameter> nozzleプリセットが存在する必要があります。スライサーの実行前に、そのinheritsとincludeの連鎖が解決されます。
• slicer_profile（またはSLICER_PROFILE）はプロセスプロファイル専用です。machine;process形式のリストは、指示とともに拒否されます。
• インストールされているスライサーに該当するプリセットがあれば、スライスではp1s、p1p、p2s、x1c、x1e、a1、a1mini、h2d、h2s、h2cを受け付けます。印刷で受け付けるのは、引き続きBAMBU_MODELにある7つのモデルのみです。
• 出力には、空でないMetadata/plate_<n>.gcodeが含まれている必要があります。失敗時は、スライサーの終了コードまたはシグナル、出力末尾、およびスライス固有のアドバイスを示して停止します。

{
  "stl_path": "/path/to/phone-case.stl",
  "slicer_type": "bambustudio",
  "bambu_model": "p1s",
  "nozzle_diameter": "0.4",
  "bed_type": "textured_plate",
  "load_filaments": "/path/to/filaments/tpu-95a-hf.json",
  "arrange": true,
  "orient": false
}

Bambu互換パスのオプション：

汎用スライサーでは、それぞれのプロファイル形式が使われます。PrusaSlicerとSlic3rはエクスポートした設定を1つ読み込み、汎用OrcaSlicerはmachine.json;process.jsonを受け取り、必要に応じてその後に|filament.jsonを指定します。slicer_type、slicer_profile、filament_profileのデフォルト値には、それぞれSLICER_TYPE、SLICER_PROFILE、FILAMENT_PROFILEが使われます。スライサー実行ファイルはSLICER_PATHから取得されます。呼び出しごとのslicer_pathには、MCP_ALLOW_EXECUTABLE_ARG=1が必要です。スライスガイドを参照してください。

slice_with_template

ローカルのテンプレートレジストリにある名前付きテンプレートを使って、STL または 3MF をスライスします。テンプレートからプロセス設定が適用されますが、マシンのプリセットは引き続き bambu_model と nozzle_diameter で指定します。slice_stl と同じ引数を受け取り、呼び出しで slicer_profile を明示すると、テンプレートより優先されます。

{
  "stl_path": "/path/to/bracket.stl",
  "template_name": "p1s-petg-strong",
  "bambu_model": "p1s"
}

list_templates

レジストリディレクトリ、BAMBU_TEMPLATE_DIR（デフォルトは ~/Sync/bambu/templates）、または template_dir 内に保存されたスライス用テンプレート（.3mf、.json、.config）を一覧表示します。

{}

save_template

ローカルの .3mf、.json、または .config ファイルをテンプレートレジストリにコピーします。template_name のデフォルト値は、拡張子を除いたコピー元のファイル名です。

{
  "source_path": "/path/to/p1s-petg-strong.3mf",
  "template_name": "p1s-petg-strong"
}

get_slice_settings

スライスを行わずに、3MF、展開済みの project_settings.config、またはプロファイル JSON に含まれるスライサー設定（レイヤー高さ、インフィル、壁、サポート、ブリム、ベッド、プリンター、フィラメント）を読み取ります。source_path、または保存済みテンプレートを読み取る場合は template_name を渡します。

{
  "template_name": "p1s-petg-strong"
}

confirm_temperatures

G-code ファイルに含まれるすべてのヒーター目標温度（S 形式と R 形式、ツール指定の目標温度、RepRapFirmware の G10／M568、Klipper の SET_HEATER_TEMPERATURE）を報告します。extruder_temp または bed_temp の期待値が一致するのは、ファイル内の最高目標温度と同じ場合だけです。この値は結果で peak として返されます。読み取り専用のツールです。印刷ツールはそれぞれ独自の安全ゲートを適用します。

{
  "gcode_path": "/path/to/model.gcode",
  "extruder_temp": 240,
  "bed_temp": 80
}

process_and_print_stl

STL のベースを拡張し、スライスして、upload_gcode および print_3mf と同じ検証済み印刷ゲート（ユーザーによる確認を含む）を通して印刷します。extruder_temp または bed_temp を渡す場合、それぞれスライス済みジョブの最高目標温度（すべてのツールの S 形式と R 形式）と一致する必要があります。一致しない場合、何もアップロードされる前に停止します。スライス済み G-code に filament_type メタデータがない場合は、material を渡します。Bambu プリンターで Bambu 対応スライサーを使う場合、スライス済みの .3mf は print_3mf のチェックを通ります。また、プリンターモデルの指定が必要です。

{
  "stl_path": "/path/to/model.stl",
  "extension_inches": 0.1,
  "extruder_temp": 210,
  "bed_temp": 60,
  "material": "PLA",
  "type": "octoprint",
  "host": "192.168.1.100"
}

印刷の確認を求める前にスライス済みファイルを確認したい場合は、slice_stl、confirm_temperatures、upload_gcode を個別に使用してください。

高度なツール

Blender MCP

BLENDER_MCP_COMMAND（たとえば uvx のフルパス）と BLENDER_MCP_ARGS（たとえば ["mcp-for-blender"]）を使って、標準の stdio Blender MCP サーバーに接続します。mcp-for-blender プロジェクトは以前 blender-mcp として公開されていましたが、互換性ラッパーとして引き続き動作します。Blender にアドオンをインストールして有効化し、アドオンの接続を開始してください。Blender とこのサーバーは、同じローカルファイルを読み取れる必要があります。プリンターツールは Blender を設定しなくても使用できます。エージェントの作業中は Blender を開いたままにしてください。アドオンはバックグラウンドモードでは動作しません。設定方法、単位、新しいスマートフォンに合わせてスマートフォンケースを一から調整する手順を説明した例については、Blender ガイドを参照してください。

blender_mcp_status

Blender MCP の設定を確認します。connect: true を指定すると、設定済みのサーバーを起動して初期化し、ツール名と概要を一覧表示します。呼び出す予定のツールの完全な入力スキーマを取得するには tool_names を渡します（include_schemas: true を指定するとすべてのスキーマが返されますが、サイズが大きくなります）。接続に成功しても、Blender 内のアドオンが実行中であるとは限りません。確認するには、blender_mcp_call を通して get_scene_info を呼び出してください。

{
  "connect": true,
  "tool_names": ["execute_blender_code"]
}

blender_mcp_call

Blender MCP サーバーが公開する get_scene_info や execute_blender_code などのツールを、検出したスキーマに合う引数で呼び出します。画像やエラーを含む完全な MCP 結果が返されます。呼び出しによってアクティブな Blender シーンが変更されることがあり、自動で再試行されることはありません。リモートツールから user_prompt を求められた場合は、ユーザー自身の言葉をそのまま保持してください。

{
  "tool_name": "get_scene_info",
  "arguments": { "user_prompt": "Inspect the scene before preparing a print." }
}