Sketchup MCP

🚀 SketchupMCP - Sketchup モデルコンテキストプロトコル（MCP）統合

SketchupMCP は、モデルコンテキストプロトコル（MCP）を通じて、Sketchup をClaude AIに接続し、Claudeが直接Sketchupとやり取りし制御できるようにします。この統合により、プロンプトを使用した3Dモデリング、シーン作成、Sketchupの操作が可能になります。

特別に mhyrr/sketchup-mcp が提供したアーキテクチャに感謝します。 私たちは、そのオリジナル版（mhyrr/sketchup-mcp）を繁体字中国語化し、一部の機能を最適化し調整しました。

✨ 主な機能

• 双方向通信：TCPソケットを通じてClaude AIとSketchupを接続します。
• コンポーネント操作：Sketchup内でコンポーネントの作成、修正、削除、変換を行います。
• 素材制御：素材と色の適用と修正を行います。
• シーンチェック：現在のSketchupシーンの詳細情報を取得します。
• 選択処理：選択されたコンポーネントを取得し操作します。
• Rubyコード実行：Sketchup内で任意のRubyコードを直接実行し、高度な操作を行います。

📦 インストール

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

1. Sketchup拡張：Sketchup内でTCPサーバーを作成し、コマンドを受信し実行する拡張機能です。
2. MCPサーバー（sketchup_mcp/server.py）：モデルコンテキストプロトコルを実装し、Sketchup拡張に接続するPythonサーバーです。

インストール手順

1. SketchupMCP拡張をダウンロードしてインストールします。
2. Sketchupを起動し、MCPサーバーを起動します。

   pip install uv
   

💻 使用例

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

1. Sketchup拡張：Sketchup内でTCPサーバーを作成し、コマンドを受信し実行する拡張機能です。
2. MCPサーバー（sketchup_mcp/server.py）：モデルコンテキストプロトコルを実装し、Sketchup拡張に接続するPythonサーバーです。

基本的な使用法

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

📚 ドキュメント

トラブルシューティング

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

🔧 技術詳細

通信プロトコル

このシステムは、TCPソケットに基づく簡単なJSONプロトコルを使用しています。

• コマンド：JSONオブジェクトとして送信され、type とオプションの params を含みます。
• 応答：JSONオブジェクトとして返され、status と result または message を含みます。

📄 ライセンス

MITライセンスが適用されます。