Bonsai MCP

🚀 bonsai - mcp - BlenderモデルコンテキストプロトコルによるIFCの統合（IfcOpenShell経由）

Bonsai - mcpは、[BlenderMCP](https://github.com/ahujasid/blender - mcp)の派生プロジェクトです。このプロジェクトはBlenderMCPの機能を拡張し、Bonsaiを通じてIFC（Industry Foundation Classes）モデルに特化したサポートを提供します。この統合は、Claude（または他のLLM、ただしここではClaude Desktop Clientのみテスト済み）をBlenderに接続し、IfcOpenShellコマンドを実行する能力を示すための迅速な概念実証です。

✨ 主な機能

• IFC固有機能：IFCモデルのクエリ、空間構造の分析、建築要素のチェックが可能です。
• 5つの強力なIFCツール：プロジェクト情報の表示、エンティティの一覧表示、属性のチェック、空間構造の探索、関係の分析ができます。
• 順序思考ツール：modelcontextprotocol/serversの順序思考ツールを使用して、構造化された問題解決が可能です。
• コード実行ツール（元のBlenderMCP実装から）：オブジェクトの作成と修正、マテリアルの適用、Blender内でのPythonコードの実行ができます。
• 検証済みの標準モデル：デフォルトのifcopenshellの住宅モデルと互換性があります。

🔧 技術詳細

IFCの統合では、Bonsai BIMモジュールを使用してIfcOpenShellの機能にアクセスします。通信は、元のBlenderMCPと同じJSONベースのプロトコルに従い、TCPソケットを介して行われます。

📚 ドキュメント

プロジェクト構造

bonsai - mcpプロジェクトは、以下の2つの主要な部分に分かれています。

1. server：クライアント（Claudeなど）からのリクエストを処理し、対応する操作を実行します。
2. client：サーバーと通信し、Blender内の操作を制御するための命令を送信します。

📦 インストール

Bonsai - mcpを使用するには、以下の手順でインストールと設定を行ってください。

1. 依存ソフトウェアのインストール

以下のソフトウェアがインストールされていることを確認してください。

• Blender（バージョン3.xを推奨）
• Python（バージョン3.8以上を推奨）
• IfcOpenShell
• Bonsai BIMプラグイン

2. リポジトリのクローン

git clone https://github.com/yourusername/bonsai - mcp.git
cd bonsai - mcp

3. Pythonパッケージのインストール

必要なPythonパッケージをインストールします。

pip install -r requirements.txt

4. サーバーの起動

Bonsai - mcpサーバーを起動します。

python server.py

5. クライアントの使用

提供されているクライアントスクリプトを使用してサーバーとやり取りします。例えば、メッセージを送信するには以下のコマンドを実行します。

python client.py --message "分析这个 IFC 模型"

💻 使用例

以下は、Bonsai - mcpを使用した操作の例です。

基本的な使用法

• モデル情報のクエリ：

python client.py --message "get_model_info"

• すべてのエンティティの一覧表示：

python client.py --message "list_entities"

高度な使用法

• 順序思考ツールの実行：

python client.py --message "sequential_thinking analyze_building_energy_efficiency"

📄 注意事項と制限

⚠️ 重要提示

• 接続に問題がある場合は、Blenderプラグインサーバーが実行中であり、Claude内のMCPサーバーが正しく設定されていることを確認してください。
• IFCモデルが読み込まれていない場合は、Bonsai BIMプラグインがインストールされ、IFCファイルが読み込まれていることを確認してください。
• タイムアウトエラーが発生した場合は、リクエストを簡素化するか、操作をより小さなステップに分割してみてください。

📄 ライセンス

貢献を歓迎します！使用条件については、プロジェクトリポジトリ内のライセンスファイルを参照してください。