Sketchup Integration

🚀 SketchupMCP - SketchUp モデルコンテキストプロトコル統合

SketchupMCP は、SketchUp を Claude AI に接続し、Model Context Protocol (MCP) を通じて Claude が直接 SketchUp と対話し制御できるようにします。この統合により、プロンプト支援による 3D モデリング、シーン作成、操作が可能になります。

Blender MCP に敬意を表し、インスピレーションと構造を提供してくれたことに感謝します。

✨ 主な機能

• 双方向通信：TCP ソケット接続を介して Claude を SketchUp に接続します。
• コンポーネント操作：SketchUp 内のコンポーネントを作成、変更、削除、変換します。
• マテリアル制御：マテリアルと色を適用および変更します。
• シーン情報：現在の SketchUp シーンの詳細情報を取得します。
• 選択処理：選択されたコンポーネントを取得し操作します。
• Ruby コード実行：任意の Ruby コードを SketchUp 内で直接実行し、高度な操作を実現します。

📦 インストール

Python パッケージ管理

uv を使用します。以下のコマンドを実行してください。

brew install uv

SketchUp プラグイン

1. 最新の .rbz ファイルをダウンロードまたはビルドします。
2. SketchUp で、Window > 拡張マネージャーに移動します。
3. "インストール拡張" をクリックし、ダウンロードした .rbz ファイルを選択します。
4. SketchUp を再起動します。

💻 使用例

接続の開始

1. SketchUp で、Extensions > SketchupMCP > サーバーを起動します。
2. サーバーはデフォルトのポート (9876) で起動します。
3. MCP サーバーが実行中であることを確認します。

Claude との統合

Claude が MCP サーバーを使用するように設定し、以下の内容を Claude の設定に追加します。

    "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 - 任意の Ruby コードを SketchUp 内で実行し、高度な操作を実現します。

サンプルコマンド

Claude が実行できるいくつかのサンプル操作を以下に示します。

• "屋根と窓のあるシンプルな家屋モデルを作成して"
• "すべてのコンポーネントを選択し、それらの情報を取得して"
• "選択されたコンポーネントを赤色に変更して"
• "選択されたコンポーネントを 10 単位上に移動して"
• "既存のシーンを 3D モデルとしてエクスポートして"
• "Ruby コードを使用して複雑なアートアンドクラフトのキャビネットを作成して"

📚 ドキュメント

トラブルシューティング

• 接続問題：SketchUp プラグインサーバーと MCP サーバーが両方とも実行中であることを確認してください。
• コマンド失敗：SketchUp の Ruby コンソールに表示されるエラーメッセージを確認してください。
• タイムアウトエラー：リクエストを簡素化するか、小さなステップに分割してみてください。

🔧 技術詳細

通信プロトコル

システムは TCP ソケットを介して JSON ベースのシンプルなプロトコルを使用します。

• コマンド は JSON 構造で送信されます。
• レスポンス はステータスコードとメッセージを含みます。
• Content-Length ヘッダーを使用してデータサイズを指定します。
• サポートされる HTTP メソッド：POST, GET, DELETE

🤝 貢献ガイド

SketchupMCP への貢献を歓迎します！ 参加方法については、CONTRIBUTING.md を参照してください。

📄 ライセンス

このプロジェクトは LICENSE に基づいて管理されています。