Open-source Revit MCP server: let Claude and other AI assistants read and edit BIM models, with human approval on every change.
Python aecai-agentsautodeskautomationbimclaudeifcmcpmcp-servermodel-context-protocolnavisworksrevitrevit-addinrevit-apirhino
param(
[string]$RevitVersion = "2027",
[string]$Version = $(if (Test-Path (Join-Path $PSScriptRoot '..\VERSION')) { (Get-Content (Join-Path $PSScriptRoot '..\VERSION') -Raw).Trim() } else { "" }),
[switch]$AllUsers,
[string]$DistPath
)
$ErrorActionPreference = "Stop"
if (-not $DistPath) {
$packagedLayout = Test-Path -LiteralPath (Join-Path $PSScriptRoot "bin")
$DistPath = if ($packagedLayout) {
$PSScriptRoot
}
else {
Join-Path $PSScriptRoot "..\dist\AECModelBridge"
}
}
$DistPath = [System.IO.Path]::GetFullPath($DistPath)
Write-Host "AEC Model Bridge Installer" -ForegroundColor Cyan
Write-Host "==================`n" -ForegroundColor Cyan
# Path Guard: Prevent Execution in System32 or Windows
if ($PSScriptRoot -like "*C:\Windows*") {
Write-Error "Dangerous path detected: $PSScriptRoot"
Write-Error "Please clone the repo to a safe location (e.g., $env:USERPROFILE\src) and run from there."
exit 1
}
# Verify dist package exists, or auto-build it
if (-not (Test-Path $DistPath)) {
Write-Host "Distribution package not found at: $DistPath" -ForegroundColor Yellow
Write-Host "Auto-triggering packaging for Revit $RevitVersion..." -ForegroundColor Cyan
& "$PSScriptRoot\package.ps1" -RevitVersion $RevitVersion -Version $Version
if (-not (Test-Path $DistPath)) {
Write-Error "Packaging failed. Please run .\scripts\package.ps1 manually to diagnose."
exit 1
}
}
$availableBinDirs = Get-ChildItem "$DistPath\bin" -Directory -ErrorAction SilentlyContinue | Select-Object -ExpandProperty Name
$versionsToInstall = if ($RevitVersion -eq "All") {
$availableBinDirs
} else {
@($RevitVersion)
}
if (-not $versionsToInstall -or $versionsToInstall.Count -eq 0) {
Write-Error "No valid Revit version binaries found in $DistPath\bin"
exit 1
}
foreach ($year in $versionsToInstall) {
# Install binaries to a version-specific ProgramData directory
Write-Host "`nInstalling binaries for Revit $year..." -ForegroundColor Yellow
$targetBin = "C:\ProgramData\AECModelBridge\bin\$year"
New-Item -ItemType Directory -Path $targetBin -Force | Out-Null
$sourceBin = "$DistPath\bin\$year"
if (-not (Test-Path $sourceBin)) {
Write-Error "Binaries for Revit $year not found in distribution package.`nAvailable versions: $($availableBinDirs -join ', ')"
exit 1
}
Get-ChildItem -Path $sourceBin -Recurse | ForEach-Object {
$relPath = $_.FullName.Substring($sourceBin.Length)
$destPath = Join-Path $targetBin $relPath
if ($_.PSIsContainer) {
New-Item -ItemType Directory -Path $destPath -Force | Out-Null
}
else {
try {
Copy-Item -LiteralPath $_.FullName -Destination $destPath -Force
}
catch {
Write-Warning "Could not copy $relPath (file locked, Revit may be running)"
}
}
}
Write-Host " Installed to: $targetBin" -ForegroundColor Green
# Install add-in manifest
Write-Host "Installing add-in manifest for Revit $year..." -ForegroundColor Yellow
$addinDir = if ($AllUsers) {
"C:\ProgramData\Autodesk\Revit\Addins\$year"
}
else {
"$env:APPDATA\Autodesk\Revit\Addins\$year"
}
New-Item -ItemType Directory -Path $addinDir -Force | Out-Null
$sourceManifest = Join-Path $DistPath "addin\AECModelBridge.addin"
$targetManifest = Join-Path $addinDir "AECModelBridge.addin"
[xml]$manifest = Get-Content -LiteralPath $sourceManifest -Raw
$manifest.RevitAddIns.AddIn.Assembly = [string](Join-Path $targetBin "AECModelBridge.dll")
$manifest.Save($targetManifest)
$legacyManifest = Join-Path $addinDir "RevitBridge.addin"
if (Test-Path $legacyManifest) {
Remove-Item -LiteralPath $legacyManifest -Force
Write-Host " Removed legacy manifest: $legacyManifest" -ForegroundColor Gray
}
$otherAddinDir = if ($AllUsers) {
"$env:APPDATA\Autodesk\Revit\Addins\$year"
}
else {
"C:\ProgramData\Autodesk\Revit\Addins\$year"
}
foreach ($duplicateName in @("AECModelBridge.addin", "RevitBridge.addin")) {
$duplicateManifest = Join-Path $otherAddinDir $duplicateName
if (Test-Path -LiteralPath $duplicateManifest) {
try {
Remove-Item -LiteralPath $duplicateManifest -Force
Write-Host " Removed duplicate manifest: $duplicateManifest" -ForegroundColor Gray
}
catch {
Write-Warning "Could not remove duplicate manifest: $duplicateManifest"
}
}
}
Write-Host " Installed manifest to: $targetManifest" -ForegroundColor Green
}
$legacyBinRoot = "C:\ProgramData\AECModelBridge\bin"
$legacyAssembly = Join-Path $legacyBinRoot "AECModelBridge.dll"
if (Test-Path -LiteralPath $legacyAssembly) {
$manifestRoots = @(
"$env:APPDATA\Autodesk\Revit\Addins",
"C:\ProgramData\Autodesk\Revit\Addins"
)
$legacyReferences = foreach ($manifestRoot in $manifestRoots) {
if (Test-Path -LiteralPath $manifestRoot) {
Get-ChildItem -LiteralPath $manifestRoot -Recurse -Filter "*.addin" -File -ErrorAction SilentlyContinue |
Where-Object {
(Get-Content -LiteralPath $_.FullName -Raw -ErrorAction SilentlyContinue) -match
[regex]::Escape($legacyAssembly)
}
}
}
if (-not $legacyReferences) {
Get-ChildItem -LiteralPath $legacyBinRoot -File -ErrorAction SilentlyContinue |
Remove-Item -Force
Write-Host " Removed obsolete shared binary files from: $legacyBinRoot" -ForegroundColor Gray
}
else {
Write-Warning "Legacy shared binaries remain because another add-in manifest still references them."
}
}
# Copy config (optional)
Write-Host "`nCopying default configuration..." -ForegroundColor Yellow
$configTarget = "C:\ProgramData\AECModelBridge\config"
New-Item -ItemType Directory -Path $configTarget -Force | Out-Null
Copy-Item "$DistPath\config\default.json" $configTarget -Force
Write-Host " Installed to: $configTarget\default.json" -ForegroundColor Green
# Copy bundled Python runtime (if present)
$sourcePython = Join-Path $DistPath "python"
$targetPython = "C:\ProgramData\AECModelBridge\python"
if (Test-Path $sourcePython) {
Write-Host "`nInstalling bundled Python runtime..." -ForegroundColor Yellow
New-Item -ItemType Directory -Path $targetPython -Force | Out-Null
# Drop the previous server package first. Copying over the top left old
# aec_model_bridge-<version>.dist-info folders behind, and Python then reports
# the oldest one as the installed version.
$targetSite = Join-Path $targetPython "Lib\site-packages"
if (Test-Path -LiteralPath $targetSite) {
try {
Get-ChildItem -LiteralPath $targetSite -Directory -Filter "aec_model_bridge-*.dist-info" |
ForEach-Object { Remove-Item -LiteralPath $_.FullName -Recurse -Force }
$oldServer = Join-Path $targetSite "revit_mcp_server"
if (Test-Path -LiteralPath $oldServer) { Remove-Item -LiteralPath $oldServer -Recurse -Force }
}
catch {
Write-Warning "Could not remove the previous server package (is an MCP client running it?): $($_.Exception.Message)"
}
}
Copy-Item "$sourcePython\*" $targetPython -Recurse -Force
Write-Host " Installed to: $targetPython" -ForegroundColor Green
}
# Installation summary
Write-Host "`n========================================" -ForegroundColor Cyan
Write-Host "Installation Complete!" -ForegroundColor Green
Write-Host "========================================" -ForegroundColor Cyan
Write-Host "`nInstalled components:" -ForegroundColor Yellow
Write-Host " Bridge DLL: $targetBin\AECModelBridge.dll"
Write-Host " Add-in: $targetManifest"
Write-Host " Config: $configTarget\default.json"
Write-Host "`nNext steps:" -ForegroundColor Yellow
Write-Host " 1. Restart Revit $RevitVersion" -ForegroundColor White
Write-Host " 2. Open a project in Revit" -ForegroundColor White
Write-Host " 3. Verify bridge: read %LOCALAPPDATA%\AECModelBridge\registry\revit-*.json and call its /health endpoint" -ForegroundColor White
Write-Host " 4. Expected response: {`"status`":`"healthy`",`"revit_version`":`"$RevitVersion`",...}" -ForegroundColor Gray
Write-Host "`nTo install MCP server:" -ForegroundColor Yellow
if (Test-Path "$DistPath\server\revit_mcp_server.exe") {
Write-Host " Run: $DistPath\server\revit_mcp_server.exe" -ForegroundColor White
}
else {
$wheel = Get-ChildItem "$DistPath\server\*.whl" -ErrorAction SilentlyContinue | Select-Object -First 1
if ($wheel) {
Write-Host " pip install $($wheel.FullName)" -ForegroundColor White
Write-Host " python -m revit_mcp_server" -ForegroundColor White
}
}
Write-Host "`nTroubleshooting:" -ForegroundColor Yellow
Write-Host " - Check Revit journal: %LOCALAPPDATA%\Autodesk\Revit\Autodesk Revit $RevitVersion\Journals\" -ForegroundColor Gray
Write-Host " - Check bridge logs: %APPDATA%\AECModelBridge\Logs\bridge.jsonl" -ForegroundColor Gray
Write-Host " - Uninstall: Remove files from paths above" -ForegroundColor Gray