Revitmcp Revit

🚀 RevitMCPプロジェクトドキュメント

RevitMCP（Revit用のモデルコンテキストプロトコル）は、RevitにMCPプロトコルに基づく自然言語対話機能を導入し、BIMモデリングとコラボレーションの効率を大幅に向上させることを目的としています。このプロジェクトは、ドメイン駆動設計（DDD）、コマンドクエリ責任分離（CQRS）パターン、および階層化アーキテクチャを採用し、複数のターゲットフレームワークをサポートしており、高い拡張性と保守性を備えています。

🚀 クイックスタート

RevitMCPを使い始めるには、まず必要な環境をセットアップする必要があります。.NET 8と.NET 9環境をインストールし、Revit 2025以上のバージョンを用意し、MCP SDKのサポートを確保してください。

✨ 主な機能

• 自然言語によるクエリとモデリングをサポート（例：「10メートル×8メートルの部屋を作成」）
• 多輪対話とパラメータ補完を実現
• 壁、窓、ドア、床板などの建築モデルを自動生成
• エンドツーエンドのプロセス間通信とフィードバックを実現
• 高度に拡張可能なDDD階層化アーキテクチャを提供
• 充実した単体テスト、統合テスト、システムテストを備える

🔧 技術詳細

アーキテクチャの階層

• RevitMCP.Plugin（.NET 8）：Revitプラグイン側で、UI画面、コマンド送信、結果表示、およびServerとの通信を担当します。
• RevitMCP.Server（.NET 9）：MCPサーバー側で、自然言語解析、コマンド分解、Revit APIの呼び出し、およびLLMクライアントとの接続を担当します。
• RevitMCP.Shared（netstandard2.0）：共有層で、DTO（データ転送オブジェクト）、インターフェース、および通信プロトコルを含みます。
• docs/：詳細な設計と専門的なドキュメントが格納されています。

技術スタック

• .NET 8（Plugin側、Revit 2025と互換性があります）
• .NET 9（Server側、MCP SDKと互換性があります）
• MCP公式C# SDK
• Revit API 2025
• テストツール：xUnit、Moq、FluentAssertions
• CI/CDツール：GitHub Actions

通信メカニズム

• PluginとServerは、MCPプロトコルを通じてプロセス間通信を実現します（標準入出力/IPCを使用し、JSON形式のメッセージを転送します）。
• Shared層では、すべてのプロセス間メッセージ、DTO、およびインターフェースを定義し、各コンポーネントの結合度を低減します。
• Server側には、LLMクライアント（Claude Desktopなど）との接続用のインターフェースが予約されています。

💻 使用例

MVPデモの流れ

1. ユーザーはRevitのRibbon画面からMCPサービスを起動します。
2. LLMクライアントで自然言語のコマンドを入力します（例：「10メートル×8メートルの部屋を作成」）。
3. プラグイン側がコマンドを送信し、Server側が解析して操作を実行します。
4. Server側がモデルを生成した後、結果をプラグイン側にフィードバックし、Revit画面に表示します。

📚 ドキュメント

開発の進捗と計画

完了済み

• 基本的なアーキテクチャの構築を完了
• PluginとServerの初期通信を実現
• 簡単な自然言語コマンドの解析をサポート

進行中

• モデル生成アルゴリズムの最適化
• 多輪対話機能の強化
• より多くのLLMクライアントへの対応拡張

計画中

• 完全なドキュメントサポートの提供
• 自動化テストプロセスの実現
• パフォーマンスとユーザー体験の最適化

ディレクトリ構造

RevitMCP/
├── RevitMCP.Plugin/          # Revitプラグインのコード
├── RevitMCP.Server/         # MCPサーバーのコード
├── RevitMCP.Shared/         # 共有コンポーネント（DTO、インターフェースなど）
└── docs/                    # ドキュメントと設計資料

依存関係の説明

• .NET 8と.NET 9環境をインストールする必要があります。
• Revit 2025以上のバージョンが必要です。
• MCP SDKのサポートが必要です。

貢献ガイド

コミュニティからの貢献を歓迎します！CONTRIBUTING.mdを参照して、どのように参加するかを確認してください。問題の報告、エラーの修正、または機能の改善をお願いします。

📄 ライセンス

このプロジェクトはMITライセンスを採用しており、詳細な条項はLICENSEファイルを参照してください。