SketchUp MCP

SketchUp MCP

英語 | Tiếng Việt

SketchUp MCP を使うと、Claude が開いている SketchUp モデルを直接操作できます。どの言語でも平易な言葉で指示でき、Claude はモデルを読み取り、タグまたはマテリアル別に数量を拾い出し、ジオメトリをモデリングし、マテリアルやタグを割り当て、自分の作業を確認するためにスクリーンショットを撮影し、画像やファイルを書き出します。Claude Desktop に組み込まれた Node.js 上で動作する Claude Desktop 拡張機能（.mcpb）と、SketchUp 用の小さな Ruby 拡張機能（SU MCP Bridge）として提供されます。Python や Node.js をインストールする必要はありません。

現在のバージョン：1.3.0 - Releases からダウンロードできます。また、公式の MCP Registry に io.github.2ez4gcx/sketchup-mcp として掲載されています。

機能

29 個のツールがあり、すべてミリメートル単位で動作します（面積は m²、体積は m³、角度は度、Z 軸は上向きです）。

主な特長：

• プロフェッショナルタグ：Claude は仕上表のように、CODE-NN description（例：FL-01 Engineered oak floor 12mm、WL-02 Walnut veneer panel、CL-01 Gypsum flat ceiling）の形式でモデルの内容にタグを付けます。仕様ごとにタグを1つ付けるため、タグ1つが数量明細表の1行になります。コードは床（FL）、幅木（SK）、壁仕上げ（WL）、間仕切り（PA）、天井（CL）、コーニス（CO）、ドア（DR）、窓（WN）、ガラス（GL）、造作家具（JN）、家具（FN）、照明（LT）、衛生器具（SN）、設備（EQ）、カーテン（CU）、装飾（DE）、既存構造（EX）、参照（RF）を表します。各タグはカテゴリ色が設定されたカテゴリ用フォルダーに入ります（SketchUp 2021 以降）。タグパネルの タグ別に色分け で色を確認できます。モデルにすでにタグ体系がある場合は、それに従います。
• 内装数量明細表（interior_takeoff）：タグごとに1行を作成し、カテゴリに応じた単位を使用します。床と天井は m²（面の向きにかかわらず各板を1回計上し、傾斜天井は実面積で計上）、壁、間仕切り、ガラスは片面の m²（壁の片面だけを貫通するドアや窓は差し引きます）、幅木とコーニスはメートル（部屋の周囲に Follow Me で作成したものも含む）、カーテンは幅 x 高さ、既存構造は m³、その他は個数で計上します。斜めに描かれた壁も直線の壁と同じ方法で計測します。カテゴリごとの合計と、タグのないオブジェクト内のジオメトリ、部屋全体を1つのボックスとして描いたもの、非表示タグ上のオブジェクト（指定がない限り計測しません）、独自のタグがない仕上げ内のコンポーネントについての警告も表示します。表を CSV ファイルとして保存し、Excel で使用できます。
• 部屋ごとの数量：各部屋のオブジェクトを、タグを付けずに名前付きグループにまとめます（例：Living room。ネストしたグループは Level 2 / Bedroom 1 のようになります）。by_room は各行を部屋ごとに分割します。CSV には合計の横に部屋ごとの列が追加されます。make_group で部屋グループを作成できます。
• タグまたはマテリアルごとの数量算出：モデル全体（または選択範囲のみ）を走査し、面積、面の数、エッジの長さ、ソリッドの体積、コンポーネントインスタンス数を集計します。タグやペイントがないエンティティは、親グループのタグまたはマテリアルを引き継ぎます。
• 表示状態を復元するスクリーンショット：Claude はビューポートの画像を直接確認できます。特定のビュー（アイソメ、上面、正面など）を要求すると、撮影時だけカメラが切り替わり、その後は元のビューに戻ります。
• 1回の取り消し操作としての run_ruby：専用ツールが適さない場合、Claude は Ruby API コードを実行できます。スニペット全体が1回の取り消し操作になります。エラーが発生すると部分的な変更はロールバックされ、メッセージにスニペット内の該当行が示されます。
• モデルの編集はすべて1回の取り消し操作です。SketchUp の「編集」メニューに MCP: ... という名前で表示されるため、Ctrl+Z を押すと Claude の操作を正確に1つだけ取り消せます。
• install_sketchup_bridge：Claude が Ruby ブリッジを自動でインストールまたは更新します。少なくとも1回起動したことがあるすべての SketchUp バージョンの Plugins フォルダーにファイルをコピーします（dry_run は実行予定の内容を報告するだけです）。
• 安全なデフォルト動作：Claude が update_existing=true を指定しない限り、既存のマテリアルの色は保持されます。delete_entities は明示的に指定した ID だけを削除し、選択範囲から削除することはありません。タイムアウト後のエラーメッセージには、コマンドがすでに実行された可能性があるかどうかが示されるため、編集を繰り返してジオメトリを重複させることを防げます。
• バージョンチェック：ping は Claude が操作しているモデルを表示し、SketchUp 内のブリッジが拡張機能に同梱されたものより古い場合は警告します。
• SketchUp メニュー（拡張機能 > SU MCP Bridge）：Start server、Stop server、Status、Open log file、Change port...。

デモ

このデモのパビリオンは MCP ツール（create_box、create_shape、run_ruby、set_material、set_tag）だけで作成し、その後 screenshot と quantity_takeoff で確認しました。ツールの呼び出しは合計82回です。

仕組み

Claude Desktop
    |  MCP over stdio
    v
sketchup-mcp-1.3.0.mcpb        Node.js MCP server, runs on the Node built into Claude Desktop
    |  one JSON request per command, TCP 127.0.0.1:9876 (localhost only)
    v
SU MCP Bridge                  Ruby extension inside SketchUp, starts with SketchUp
    |  SketchUp Ruby API
    v
the open SketchUp model

要件

• Claude Desktop（設定 > 拡張機能 がある最新バージョン）に、Claude アカウントでサインインしていること。
• SketchUp 2017 以降（デスクトップ版）。SketchUp 2021 と 2023 でテスト済みです。ブリッジをインストールする前に、各バージョンの SketchUp を少なくとも一度起動しておく必要があります。
• Windows 10/11：テスト済みです。macOS：未テストです（拡張機能は macOS 用にパッケージ化されており、インストーラーは macOS の Plugins フォルダーを認識しますが、Mac では動作確認されていません）。
• ソースからビルドする場合のみ：Node.js 18 以降と npm。

ダウンロード

最新リリースからファイルを入手します。

インストール

1. Claude Desktop に拡張機能をインストールします。 設定 > 拡張機能 を開き、sketchup-mcp-1.3.0.mcpb をウィンドウにドラッグ＆ドロップするか、詳細設定 > 拡張機能をインストール... をクリックしてファイルを選択します。インストール をクリックします。このビルドにはコード署名がないため、Claude Desktop に未署名の拡張機能であると警告される場合があります。このプロジェクトのリリースから入手したファイルか、自分でビルドしたファイルのみをインストールしてください。Microsoft Store 版の Claude では、.mcpb ファイルをダブルクリックしても開けないため、設定からインストールしてください。

2. SketchUp に SU MCP Bridge をインストールします。 新しいチャットで、Claude に次のように依頼します。

   SketchUp に SU MCP Bridge をインストールして

   Claude が install_sketchup_bridge を呼び出します（許可 をクリックしてください）。更新された SketchUp のバージョンが一覧表示されます。または、手動でインストールします。拡張機能 > Extension Manager > Install Extension（SketchUp 2017-2020 の場合：ウィンドウ > Extension Manager）を開き、su_mcp.rbz を選択します。このプラグインにはデジタル署名がありません。SketchUp が読み込みを拒否する場合は、IT ポリシーで許可されていれば、Extension Manager の歯車アイコンから Extension Loading Policy を Approve Unidentified Extensions に設定してください。

3. SketchUp を完全に終了してから、再起動します。 次に、拡張機能 > SU MCP Bridge > ステータス を確認します。SU MCP Bridge v1.3.0: RUNNING on 127.0.0.1:9876 と表示されるはずです。最後に、Claude に「Ping SketchUp」と依頼します。

設定は 設定 > 拡張機能 > SketchUp MCP > 設定 にあります。ブリッジのポート（既定値は 9876）と、コマンドごとのタイムアウト（既定値は 120 s。大規模モデルの数量拾いでは延長してください）を設定できます。ポートを変更した場合は、SketchUp 側でも変更し（拡張機能 > SU MCP Bridge > ポートを変更...）、SketchUp を再起動してください。

更新するには、新しい .mcpb を古いものに上書きしてインストールし（設定は保持されます）、Claude にブリッジの再インストールを依頼してから、SketchUp を再起動します。必ず両方のコンポーネントを更新してください。

サンプルプロンプト：mcpb/release-docs/en/SAMPLE_PROMPTS.txt。ユーザーガイド（HTML と PDF）はリリース ZIP（GUIDE_EN.html / GUIDE_EN.pdf）に含まれており、各リリースにも添付されています。ソースはmcpb/release-docs/en/GUIDE.htmlです。

その他の MCP クライアント

.mcpb によるワンクリックインストールは Claude Desktop 専用ですが、このサーバーは stdio を使用する標準的な MCP サーバーのため、ローカルの MCP サーバーを起動できるクライアントであれば利用できます。Claude Desktop 以外で使用する場合は、PATH 上に Node.js 18 以降が必要です。

1. サーバーを入手します。 .mcpb ファイルは ZIP アーカイブです。任意のフォルダーに展開してください。たとえば、Windows 10/11 に付属する tar をコマンドプロンプトまたは PowerShell で使用できます（Git Bash の tar では読み込めません）。ファイル名を .zip に変更して すべて展開 を使用することもできます。

mkdir C:\Tools\sketchup-mcp
tar -xf sketchup-mcp-1.3.0.mcpb -C C:\Tools\sketchup-mcp

サーバーは C:/Tools/sketchup-mcp/server/index.mjs にあります（設定ではスラッシュを使用してください）。フォルダーにはブリッジファイルも含まれているため、install_sketchup_bridge はどのクライアントからでも動作します。ソースからビルドすることもできます （mcpb/dist/bundle/server/index.mjs）。

2. クライアントに登録します（以下のスニペットを参照）。任意の環境変数：SKETCHUP_MCP_PORT（デフォルトは 9876）と SKETCHUP_MCP_TIMEOUT（コマンドごとの秒数、デフォルトは 120）。クライアントに独自のツール呼び出しタイムアウトがある場合は、 SKETCHUP_MCP_TIMEOUT より大きな値に設定してください。

3. インストールの手順 2～3 に従ってブリッジをインストールします（アシスタントに install_sketchup_bridge を実行するよう依頼するか、 su_mcp.rbz を使用します）。その後、SketchUp を再起動してください。

スクリーンショットは MCP 画像として返されるため、それを「見る」にはモデルが画像入力に対応している必要があります。ツールの説明は あらゆるモデル向けに記述されていますが、ツールの使用品質はモデルによって異なります。別の SketchUp MCP サーバーがすでに sketchup という名前で登録されている場合は、重複したツールを避けるため、こちらには別の名前（例：sketchup-node）を付けてください。

claude mcp add sketchup --scope user -e SKETCHUP_MCP_TIMEOUT=120 -- node C:/Tools/sketchup-mcp/server/index.mjs
claude mcp list

{
  "mcpServers": {
    "sketchup": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Tools/sketchup-mcp/server/index.mjs"],
      "env": { "SKETCHUP_MCP_TIMEOUT": "120" }
    }
  }
}

{
  "servers": {
    "sketchup": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Tools/sketchup-mcp/server/index.mjs"],
      "env": { "SKETCHUP_MCP_TIMEOUT": "120" }
    }
  }
}

{
  "mcpServers": {
    "sketchup": {
      "command": "node",
      "args": ["C:/Tools/sketchup-mcp/server/index.mjs"],
      "env": { "SKETCHUP_MCP_TIMEOUT": "120" }
    }
  }
}

[mcp_servers.sketchup]
command = "node"
args = ["C:/Tools/sketchup-mcp/server/index.mjs"]
tool_timeout_sec = 180

[mcp_servers.sketchup.env]
SKETCHUP_MCP_TIMEOUT = "120"

{
  "mcpServers": {
    "sketchup": {
      "command": "node",
      "args": ["C:/Tools/sketchup-mcp/server/index.mjs"],
      "env": { "SKETCHUP_MCP_TIMEOUT": "120" }
    }
  }
}

ChatGPT ウェブ版はローカルプログラムを起動できません。このサーバーをパブリック HTTPS エンドポイントで公開する必要があります。 これは推奨されません。run_ruby は SketchUp 内で任意の Ruby を実行し、ブリッジには認証機能がありません。 代わりに ChatGPT デスクトップアプリ（Codex モード）を使用してください。

安全に関する注意事項

• ローカルホストのみ。 ブリッジは 127.0.0.1 で待ち受けるため、ネットワーク上の他のマシンからは接続できません。ただし、ソケットに認証機能はありません。ブリッジの実行中は、同じコンピューター上で動作するプログラムならどれでもコマンドを送信できます。現在のセッションでブリッジを停止するには、Extensions > SU MCP Bridge > Stop server を使用してください（SketchUp の起動時に再び起動します）。
• 承認を有効にしておいてください。 Claude Desktop はツールを呼び出すたびに確認を求めます。run_ruby、delete_entities、undo、save_model、open_model、new_model、export_file、export_png、interior_takeoff では「Always allow」を選択しないでください（エクスポートツールと、CSV を保存する場合の数量集計ツールは、ファイルを上書きする可能性があります）。
• run_ruby は SketchUp 内で任意の Ruby コードを実行します。 ユーザーの権限で、時間制限なく実行されます。許可する前にコードを確認してください。無限ループが発生すると SketchUp がフリーズし、Task Manager から終了して、保存していない変更を失うことになります。
• 編集はすべて 1 回の Undo ステップとして扱われます。 そのため、誤った結果は Ctrl+Z を押すか、Claude に取り消しを依頼することで元に戻せます。
• プロジェクトのコピーを使い、Claude との各セッションの前にコピーを保存してください。 パスを指定せずに save_model を実行すると、現在のファイルが上書きされます。
• モデルデータは Claude に送信されます。 質問すると、Claude はモデル情報（オブジェクト名、数量、スクリーンショットなど）を読み取り、処理のために Anthropic の Claude サービスへ送信します。機密性の高いプロジェクトについては、所属組織およびクライアントの規則に従ってください。

トラブルシューティング

ログファイル（Extensions > SU MCP Bridge > Open log file）にはコマンド名、時刻、エラーメッセージが記録されますが、ジオメトリやコード全体は記録されません。エラーメッセージに run_ruby コードの一部やファイル名、オブジェクト名が含まれる場合があるため、共有する前にファイルを確認してください。

ソースからビルドする

cd mcpb
npm install
npm run build     # bundle with esbuild, build su_mcp.rbz from ../extension, validate + pack dist/sketchup-mcp-<version>.mcpb
npm test          # smoke test + unit tests against a mock bridge (no SketchUp needed)
npm run release   # build + unit tests + ../release/SketchUpMCP_v<version>/ and its .zip (PDF guides need Microsoft Edge)

• バージョンは 4 か所（mcpb/package.json、mcpb/manifest.json、extension/su_mcp/main.rb の VERSION、extension/su_mcp.rb の ext.version）で一致している必要があります。一致しない場合、ビルドは停止します。
• Ruby ブリッジでは、SketchUp 2017 以降で動作するよう、Ruby 2.2 の構文を維持してください（&.、Array#sum、match? などは使用できません）。
• manifest.json の name（sketchup-mcp）や author.name は変更しないでください。Claude Desktop はこれらをインストール ID として使用するため、どちらかを変更すると、新しいリリースは更新ではなく 2 つ目の拡張機能としてインストールされます。
• node scripts/smoke-test.mjs --live は、実行中の SketchUp に対して読み取り専用ツールを呼び出します。安全に作業できるモデルでのみ使用してください。

リポジトリの構成

extension/                   Ruby bridge (SU MCP Bridge)
  su_mcp.rb                  loader registered with SketchUp
  su_mcp/main.rb             TCP server on 127.0.0.1, commands, menu, status, log
mcpb/                        Node.js MCP server packaged as a Claude Desktop extension
  src/index.mjs              MCP tools, connection to the bridge, install_sketchup_bridge
  manifest.json              .mcpb manifest (tools, user settings: port, timeout)
  scripts/                   build.mjs, unit-test.mjs, smoke-test.mjs, release.mjs, versions.mjs, make-icon.mjs
  release-docs/en/           GUIDE.html, SAMPLE_PROMPTS.txt (English)
  release-docs/vi/           HUONG_DAN_SU_DUNG.html, CAU_LENH_MAU.txt (Vietnamese)
docs/images/                 README images (hero, demo GIF, social preview)
server.json                  entry for the official MCP Registry
.github/workflows/ci.yml     build + tests on Windows
.github/workflows/publish-mcp-registry.yml   publishes server.json to the MCP Registry (run by hand)

クレジット

一部のアイデアはzinin/sketchup-mcp2（MIT）から得ています。eval 内のすべての例外を捕捉すること、「すでに実行された可能性があります」というメッセージ、キャプチャ後のカメラの復元、最小バージョンの確認です。コードはコピーしていません。サーバーにバンドルされているサードパーティライブラリとそのライセンスは、ビルド時に生成されるTHIRD_PARTY_NOTICES.txtに記載されています。

SketchUp は Trimble Inc. の商標です。Claude は Anthropic の商標です。このプロジェクトは、いずれの企業とも提携しておらず、いずれの企業からも承認されていません。

ライセンス

MIT Licenseの下で公開されています。Copyright (c) 2026 Khuong Doan。