Revit MCP

🚀 🏗️ Revit MCP サーバー

TypeScript ベースのモデルコンテキストプロトコル（Model Context Protocol）サーバーです。Claude AI と Autodesk Revit のシームレスな統合を実現し、WebSocket 接続を通じて直接 Revit モデルにアクセスできるようにします。

English | 中文

🚀 クイックスタート

この TypeScript ベースの MCP サーバーは、Claude AI と Revit の間の橋渡しとして機能し、WebSocket 接続を通じて Revit モデル情報にリアルタイムでアクセスできます。モデルコンテキストプロトコルを実装することで、以下のことが可能になります。

• ⚡ Revit モデル情報のリアルタイム取得
• 🔍 要素のクエリとフィルタリング
• 👀 ビューと階層の管理
• 🛡️ 堅牢なエラー処理とモックデータのフォールバック

✨ 主な機能

🔌 Revit 統合

• 📡 WebSocket を通じた Revit プラグイン通信
• 🔄 リアルタイムのモデルデータアクセス
• 🔁 接続失敗時に自動的にモックデータにフォールバック
• ⚙️ 環境変数を通じた接続設定の構成

🚀 核心機能

• 📊 モデル情報

  • 基本的なモデルメタデータ（名前、パス、バージョン）の取得
  • 要素の数と最終更新日の取得
  • モデルの状態をリアルタイムで同期

• 🏗️ 要素管理

  • 柔軟なフィルターを使用した要素のクエリ
  • 要素の属性と形状へのアクセス
  • 要素の一括操作

• 🎪 ビューと階層の制御

  • 利用可能なすべてのビューのリスト表示
  • 階層情報の取得
  • モデルの階層構造の走査

💻 開発

📋 前提条件

• Node.js (v14 以上)
• npm
• Autodesk Revit (2023 以上)
• Revit WebSocket プラグイン（セットプラグイン）

🔧 インストール

依存関係のインストール：

npm install

サーバーのビルド：

npm run build

開発時の自動再構築：

npm run watch

⚙️ 設定

サーバーは環境変数を通じて設定できます。

REVIT_HOST=127.0.0.1    # Revit プラグイン WebSocket サーバーのアドレス
REVIT_PORT=8080         # Revit プラグイン WebSocket のポート

🔗 Claude Desktop との統合

サーバーの設定を Claude Desktop に追加します。

Windows:

%APPDATA%/Claude/claude_desktop_config.json

設定形式：

{
  "mcpServers": {
    "revit-mcp-server": {
      "command": "D:/path/to/revit-mcp-server/build/index.js"
    }
  }
}

🐛 デバッグ

MCP 通信のデバッグ：

1. 組み込みの MCP インスペクターツールを使用：

npm run inspector

2. Revit プラグインとの間の WebSocket 通信を監視
3. サーバーのログを確認して接続と操作の状態情報を取得

⚠️ エラー処理

サーバーは堅牢なエラー処理メカニズムを実装しています。

• Revit への接続失敗時に自動的にモックデータにフォールバック
• 詳細なエラー記録
• スムーズな接続回復

📄 ライセンス

MIT License

🤝 貢献

貢献を歓迎します！自由にプルリクエストを送信してください。

📬 連絡先

何か質問や提案があれば、いつでも以下の方法で連絡してください。

• 📧 メールアドレス：353554036@qq.com
• 💬 微信アカウント：modian4500