SketchupMCP - Sketchup モデルコンテキストプロトコルの統合
SketchupMCPは、Model Context Protocol(MCP)を介してSketchupをClaude AIに接続し、ClaudeがSketchupを直接操作できるようにします。この統合により、Sketchupでプロンプト支援による3Dモデリング、シーン作成、操作が可能になります。
インスピレーションと構造を提供してくれたBlender MCPに大感謝です。
特徴
双方向通信: TCPソケット接続を介してClaude AIをSketchupに接続します
コンポーネント操作: Sketchup でコンポーネントを作成、変更、削除、変換します
マテリアルコントロール: マテリアルと色を適用および変更します
シーン検査: 現在の Sketchup シーンの詳細情報を取得します
選択処理: 選択されたコンポーネントを取得して操作する
Ruby コードの評価: 高度な操作のために SketchUp で任意の Ruby コードを直接実行します
Related MCP server: SketchUp MCP Server
コンポーネント
このシステムは、次の 2 つの主要コンポーネントで構成されています。
Sketchup 拡張機能: Sketchup 内に TCP サーバーを作成し、コマンドを受信して実行する Sketchup 拡張機能
MCP サーバー ( : モデルコンテキストプロトコルを実装し、Sketchup 拡張機能に接続する Python サーバー
インストール
Python パッケージング
uv を使用するので、 brew install uv実行する必要があります。
スケッチアップ拡張機能
最新の
.rbzファイルをダウンロードまたはビルドしますSketchupで、「ウィンドウ」>「拡張機能マネージャ」に移動します。
「拡張機能をインストール」をクリックし、ダウンロードした
.rbzファイルを選択します。SketchUpを再起動する
使用法
接続の開始
Sketchupで、拡張機能 > SketchupMCP > サーバーを起動に移動します。
サーバーはデフォルトのポート(9876)で起動します。
ターミナルでMCPサーバーが実行中であることを確認してください
クロードと一緒に使う
Claude 構成に以下を追加して、Claude が MCP サーバーを使用するよう構成します。
これはPyPIから最新のものを取得します
接続すると、Claude は次の機能を使用して Sketchup を操作できるようになります。
ツール
get_scene_info- 現在のSketchupシーンに関する情報を取得しますget_selected_components- 現在選択されているコンポーネントに関する情報を取得しますcreate_component- 指定されたパラメータで新しいコンポーネントを作成するdelete_component- シーンからコンポーネントを削除しますtransform_component- コンポーネントを移動、回転、または拡大縮小するset_material- コンポーネントにマテリアルを適用するexport_scene- 現在のシーンをさまざまな形式でエクスポートしますeval_ruby- SketchUp で任意の Ruby コードを実行して高度な操作を実行します
コマンド例
クロードに依頼できる作業の例をいくつか示します。
「屋根と窓のあるシンプルな家のモデルを作成する」
「すべてのコンポーネントを選択して情報を取得する」
「選択したコンポーネントを赤にする」
「選択したコンポーネントを10単位上に移動する」
「現在のシーンを3Dモデルとしてエクスポートする」
「Ruby コードを使用して複雑なアート クラフト キャビネットを作成する」
トラブルシューティング
接続の問題: Sketchup拡張機能サーバーとMCPサーバーの両方が実行中であることを確認してください
コマンドの失敗: Sketchup の Ruby コンソールでエラー メッセージを確認してください
タイムアウトエラー: リクエストを簡素化するか、小さなステップに分割してみてください
技術的な詳細
通信プロトコル
システムは TCP ソケット上でシンプルな JSON ベースのプロトコルを使用します。
コマンドは、
typeとオプションのparamsを持つJSONオブジェクトとして送信されます。レスポンスは
statusとresultまたはmessageを持つJSONオブジェクトです
貢献
貢献を歓迎します!お気軽にプルリクエストを送信してください。
ライセンス
マサチューセッツ工科大学