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: SketchupMCP

コンポーネント

このシステムは、次の 2 つの主要コンポーネントで構成されています。

1. Sketchup 拡張機能: Sketchup 内に TCP サーバーを作成し、コマンドを受信して実行する Sketchup 拡張機能

2. MCP サーバー ( : モデルコンテキストプロトコルを実装し、Sketchup 拡張機能に接続する Python サーバー

インストール

Python パッケージング

uv を使用するので、 brew install uv実行する必要があります。

スケッチアップ拡張機能

1. 最新の.rbzファイルをダウンロードまたはビルドします

2. Sketchupで、「ウィンドウ」>「拡張機能マネージャ」に移動します。

3. 「拡張機能をインストール」をクリックし、ダウンロードした.rbzファイルを選択します。

4. SketchUpを再起動する

使用法

接続の開始

1. Sketchupで、拡張機能 > SketchupMCP > サーバーを起動に移動します。

2. サーバーはデフォルトのポート（9876）で起動します。

3. ターミナルでMCPサーバーが実行中であることを確認してください

クロードと一緒に使う

Claude 構成に以下を追加して、Claude が MCP サーバーを使用するよう構成します。

    "mcpServers": {
        "sketchup": {
            "command": "uvx",
            "args": [
                "sketchup-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オブジェクトです

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

マサチューセッツ工科大学