SketchupMCP

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables two-way communication with SketchUp, allowing component creation, manipulation, and transformation; material application; scene inspection; selection handling; and execution of Ruby code for 3D modeling and scene management.

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 コードを直接実行します

コンポーネント

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

  1. Sketchup 拡張機能: Sketchup 内に TCP サーバーを作成し、コマンドを受信して実行する Sketchup 拡張機能
  2. MCP サーバー ( sketchup_mcp/server.py ) : モデルコンテキストプロトコルを実装し、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オブジェクトとして送信されます。
  • レスポンスstatusresultまたはmessageを持つJSONオブジェクトです

貢献

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

ライセンス

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

-
security - not tested
F
license - not found
-
quality - not tested

モデル コンテキスト プロトコルを介して Sketchup を Claude AI に接続し、Claude が Sketchup を直接操作して制御し、プロンプト支援による 3D モデリングとシーン操作を実行できるようにします。

  1. Features
    1. Components
      1. Installation
        1. Python Packaging
        2. Sketchup Extension
      2. Usage
        1. Starting the Connection
        2. Using with Claude
        3. Example Commands
      3. Troubleshooting
        1. Technical Details
          1. Communication Protocol
        2. Contributing
          1. License
            ID: klbs5dmoei