mcp-server-for-revit

MCP-Server (Node.js) zur Interaktion mit Autodesk Revit über KI-Assistenten (Claude, Cursor, etc.).

Dieses Repository enthält zwei Dinge, die man unterscheiden sollte:

1. Das „ursprüngliche“ MCP (Node-Bridge) — ausgerichtet am Ökosystem mcp-servers-for-revit: stellt Revit-Operationen als MCP-Tools bereit; der Server kommuniziert mit dem offiziellen Revit-Plugin über TCP (standardmäßig Port 8080), nicht über WebSocket in diesem Bridge-Flow.

2. Die Erweiterung dieses Forks — Dual-Port in der Bridge (REVIT_PLUGIN_PORT / REVIT_SKETCH_PORT) und das separate Add-in RevitSketchPoC (C# / WPF) im Ordner revit-plugin/RevitSketchPoC/, das auf einem anderen Port lauscht (standardmäßig 8081) und nur das Tool create_house_from_sketch verarbeitet (Bildinterpretation + Erstellung von Wänden/Räumen/Türen in Revit), mit konfigurierbarem Ollama oder Gemini im Plugin.

[!NOTE] Für den vollständigen Ablauf benötigen Sie das ursprüngliche Revit-Plugin (Port 8080) und, falls Sie die Skizzenfunktion über MCP oder UI nutzen, das RevitSketchPoC (Port 8081). Anweisungen zum offiziellen Plugin: mcp-servers-for-revit. Details zum PoC: revit-plugin/RevitSketchPoC/README.md.

Sicherheit und Git

• Keine Commits von .env-Dateien, JSON-Schlüsseln oder lokalen Kopien mit Geheimnissen. Das Repository enthält eine .gitignore für node_modules/, .NET-Artefakte (bin/ / obj/), .env* und pluginsettings.local.json.

• Die Datei deploy/pluginsettings.json des PoC sollte im Git GeminiApiKey leer lassen; verwenden Sie eine lokale Kopie oder folgen Sie der pluginsettings.example.json als Vorlage.

Setup (MCP-Client)

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"
            }
        }
    }
}

Starten Sie den Client neu. Das Tool-Symbol zeigt an, dass das MCP verbunden ist.

Zwei Ports, zwei Plugins

Das Tool create_house_from_sketch verwendet REVIT_SKETCH_PORT (oder data.pluginPort in der Anfrage). Das Feld pluginPort wird nicht an Revit gesendet (die Bridge entfernt es). Die restlichen Tools verwenden REVIT_PLUGIN_PORT.

Unterstützte MCP-Tools

Entwicklung (Node)

npm install
npm run build

Sketch PoC (C# / WPF)

Die aktuelle und unterstützte Implementierung befindet sich in revit-plugin/RevitSketchPoC/ (UI, MCP-TCP-Router, Ollama/Gemini, Revit-Transaktionen). Der Ordner samples/RevitSketchPoC/ existiert möglicherweise als alte Referenz; folgen Sie dem Plugin-README unter revit-plugin/RevitSketchPoC/README.md.

Zusammengefasster Ablauf:

1. Benutzer sendet Bild (Ribbon Sketch AI PoC oder MCP create_house_from_sketch).

2. Das Plugin ruft das LLM auf (Ollama oder Gemini gemäß pluginsettings.json).

3. Strukturierte Antwort → Erstellung von Elementen in einer Transaction in Revit.

Lizenz

MIT