mcp-server-for-revit

AIアシスタント（Claude、Cursorなど）からAutodesk Revitを操作するためのMCPサーバー（Node.js）。

このリポジトリには、区別すべき2つの要素が含まれています：

1. 「オリジナル」のMCP（Nodeブリッジ） — mcp-servers-for-revit エコシステムに準拠しており、Revitの操作を MCPツール として公開します。このサーバーは、WebSocketではなく TCP（デフォルトポート 8080）を介して 公式Revitプラグイン と通信します。

2. このフォークの拡張機能 — ブリッジにおける デュアルポート（REVIT_PLUGIN_PORT / REVIT_SKETCH_PORT）と、revit-plugin/RevitSketchPoC/ フォルダ内にある独立したアドイン RevitSketchPoC（C# / WPF）です。これは別のポート（デフォルト 8081）をリッスンし、create_house_from_sketch ツール（画像解釈 + Revit内での壁/部屋/ドアの作成）のみを処理します。プラグイン内で Ollama または Gemini を設定可能です。

[!NOTE] 完全なフローには、オリジナルのRevitプラグイン（ポート 8080）と、MCPまたはUI経由でスケッチを使用する場合は RevitSketchPoC（ポート 8081）が必要です。公式プラグインの手順：mcp-servers-for-revit。PoCの詳細：revit-plugin/RevitSketchPoC/README.md。

セキュリティとGit

• .env ファイル、JSON内のキー、またはシークレットを含むローカルコピーを コミットしないでください。リポジトリには、node_modules/、.NETアーティファクト（bin/ / obj/）、.env*、および pluginsettings.local.json 用の .gitignore が含まれています。

• PoCの deploy/pluginsettings.json ファイルでは、Git上で GeminiApiKey を空 にしておく必要があります。ローカルコピーを使用するか、pluginsettings.example.json をテンプレートとして使用してください。

セットアップ (MCPクライアント)

Claude Code

claude mcp add mcp-server-for-revit -- npx -y mcp-server-for-revit

Claude Desktop — claude_desktop_config.json:

{
    "mcpServers": {
        "mcp-server-for-revit": {
            "command": "npx",
            "args": ["-y", "mcp-server-for-revit"],
            "env": {
                "REVIT_PLUGIN_PORT": "8080",
                "REVIT_SKETCH_PORT": "8081"
            }
        }
    }
}

クライアントを再起動します。ツールアイコンが表示されれば、MCPが接続されています。

2つのポート、2つのプラグイン

create_house_from_sketch ツールは REVIT_SKETCH_PORT（またはリクエスト内の data.pluginPort）を使用します。pluginPort フィールドはRevitには送信されません（ブリッジによって削除されます）。その他のツールは REVIT_PLUGIN_PORT を使用します。

サポートされているMCPツール

開発 (Node)

npm install
npm run build

Sketch PoC (C# / WPF)

現在サポートされている実装は revit-plugin/RevitSketchPoC/ にあります（UI、MCP TCPルーター、Ollama/Gemini、Revitトランザクション）。samples/RevitSketchPoC/ フォルダは古い参照として存在する可能性があります。revit-plugin/RevitSketchPoC/README.md にあるプラグインのREADMEに従ってください。

フローの概要:

1. ユーザーが画像を送信（リボン Sketch AI PoC または MCP create_house_from_sketch）。

2. プラグインがLLMを呼び出す（pluginsettings.json に応じてOllamaまたはGemini）。

3. 構造化された応答 → Revitの Transaction 内で要素を作成。

ライセンス

MIT