Rhino 3D

🚀 Rhino MCP サーバー

このプロジェクトは、MCP プロトコルを通じて Rhino 3D の AI 支援モデリング機能を実現し、ユーザーが AI アシスタント（Claude など）を介して 3D オブジェクトを作成および操作できるようにすることを目的としています。

⚠️ 重要提示

このプロジェクトは現在積極的に開発中で、まだ正常に動作していません。Rhino プラグインはオブジェクトを作成する際に問題があります。 私たちは、特に Rhino API、C# プラグイン、または MCP 統合に精通した開発者を含むコミュニティの支援を積極的に求めています。

🚀 クイックスタート

このプロジェクトはまだ開発段階であり、まだ完全に機能する状態ではありません。現在、Rhino プラグインのオブジェクト作成に問題があり、開発者による修正が必要です。

📚 ドキュメント

🔍 概要

このプロジェクトは、MCP プロトコルを通じて Rhino 3D の AI 支援モデリング機能を実現することを目指しています。ユーザーは AI アシスタント（Claude など）を使用して 3D オブジェクトを作成および操作できます。ただし、現在は開発段階であり、特にプラグインのオブジェクト作成時の安定性に問題があります。

📦 システムアーキテクチャ

プロジェクトの構造は以下の通りです。

1. Python スクリプト：

   • combined_mcp_server.py：メインの MCP サーバーの実装。
   • diagnose_rhino_connection.py：Rhino の接続状態をテストするための診断ツール。
   • log_manager.py：ログファイルを管理し、分析機能を提供します。

2. Shell スクリプト：

   • server_launcher.sh：複数のサーバーモードをサポートする統一的な起動スクリプト。

3. ディレクトリ構造：

   • logs/：すべてのコンポーネントのログファイルを保存します。

✨ 主な機能

1. MCP サーバーの実装

• combined_mcp_server.py：コアサーバーの実装で、以下のツールをサポートしています。
  • geometry_tools.create_sphere：指定された中心と半径の球体を作成します。
  • geometry_tools.create_box：指定されたサイズの直方体を作成します。
  • geometry_tools.create_cylinder：指定されたパラメータの円柱体を作成します。
  • scene_tools.get_scene_info：現在のシーン情報を取得します。
  • scene_tools.clear_scene：シーン内のすべてのオブジェクトをクリアします。
  • scene_tools.create_layer：ドキュメント内に新しいレイヤーを作成します。

2. プラグイン開発

• Rhino プラグイン：Rhino とのやり取りを担当しますが、現在は以下の問題があります。
  • オブジェクトの作成に失敗することがあり、さらなるデバッグと修正が必要です。

📝 ログシステム

プロジェクトは統一的なログフレームワークを採用しており、以下の内容を記録します。

• サーバーログ
• プラグインログ
• AI ワークステーションログ
• 診断ログ

すべてのログはコンポーネントごとに logs/ ディレクトリに分類されて保存され、一貫した形式に従っています。log_manager.py を使用することで、ログの表示、分析、およびレポートの生成が可能です。

🛠️ 開発ガイド

プロジェクト構造

.
├── combined_mcp_server.py       # メインの MCP サーバーの実装。
├── diagnose_rhino_connection.py # Rhino の接続状態をテストするための診断ツール。
├── log_manager.py               # ログ管理ツール。
└── server_launcher.sh           # 統一的な起動スクリプト。

新機能の追加

1. 新しいツールの追加：

   • combined_mcp_server.py に新しい機能メソッドを追加します。
   • 既存のログ記録規則に従うようにしてください。

2. 診断と修正：

   • diagnose_rhino_connection.py を使用して、プラグインと Rhino の接続状態をテストします。
   • 現在のオブジェクト作成の問題を修正し、プラグインが安定して動作するようにします。

3. ログ管理：

   • 新しい機能モジュールをサポートするようにログフレームワークを更新します。
   • すべてのログ出力が統一された形式に従うようにしてください。

🐞 トラブルシューティング

よくある問題

1. 接続失敗：

   • 古いプロセスがポートまたはリソースを占有していないか確認します。
   • server_launcher.sh help を使用して関連するサービスを再起動します。

2. ログ分析：

   • logs/ ディレクトリ内の詳細なログを確認して問題を特定します。
   • log_manager.py report を使用してエラーレポートを生成します。

3. プラグインのデバッグ：

   • Rhino で開発者モードを有効にし、プラグインの読み込み状態を確認します。
   • すべての API 呼び出しが正しいことを確認します。

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルを参照してください。