KGS-Revit-MCP

Project trung tâm phát triển MCP Server kết nối AI với Autodesk Revit - dành cho KGS Architecture.

Repo này là nơi code và update toàn bộ bộ MCP Revit, gộp source của 3 repo MCP server hàng đầu.

📦 Cấu trúc project

KGS-Revit-MCP/
├── mcp-servers-for-revit/   # Bản chính hãng (23 tools) - TypeScript + C#
├── rvt-mcp/                 # bimwright (220 tools) - C# .NET 8
├── REVIT_MCP_study/         # shuotao (167 tools) - Node.js + C#
├── audit/                   # Báo cáo audit
│   ├── audit-report.pdf
│   └── audit-report.html
├── docs/                    # Tài liệu nội bộ KGS
└── README.md

🧩 3 MCP Server

Thư mục	Nguồn	Tools	Điểm mạnh
mcp-servers-for-revit/	mcp-servers-for-revit	23	Cơ bản, ổn định
rvt-mcp/	bimwright/rvt-mcp	220	Audit, materials, families, export
REVIT_MCP_study/	shuotao/REVIT_MCP_study	167	Clash detection, compliance

🚀 Cài đặt từng MCP

1. mcp-servers-for-revit (bản chính hãng)

Plugin Revit: Tải release ZIP từ Releases → giải nén vào %AppData%\Autodesk\Revit\Addins\<version>\

MCP Server:

npm install -g mcp-server-for-revit

2. rvt-mcp (bimwright) - MẠNH NHẤT

$tag = (Invoke-RestMethod https://api.github.com/repos/bimwright/rvt-mcp/releases/latest).tag_name
$zip = "$env:TEMP\RvtMcp.Setup-$tag-win-x64.zip"
$dir = "$env:TEMP\RvtMcp.Setup-$tag-win-x64"
Invoke-WebRequest "https://github.com/bimwright/rvt-mcp/releases/download/$tag/RvtMcp.Setup-$tag-win-x64.zip" -OutFile $zip
Expand-Archive $zip -DestinationPath $dir -Force
powershell -ExecutionPolicy Bypass -File "$dir\install.ps1"

Hỗ trợ Revit 2022-2027. Server cài tại %LOCALAPPDATA%\RvtMcp\rvt\server\<version>\rvt-mcp.exe.

3. REVIT_MCP_study (shuotao - clash detection)

cd REVIT_MCP_study
powershell -ExecutionPolicy Bypass -File scripts/setup.ps1 -NonInteractive -RevitVersions "2026"

Yêu cầu: .NET 8 SDK, .NET 10 SDK, Nice3point.Revit.Templates.

⚙️ Cấu hình MCP (VS Code mcp.json)

{
  "servers": {
    "mcp-server-for-revit": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users/abrah/AppData/Roaming/npm/node_modules/mcp-server-for-revit/build/index.js"]
    },
    "rvt-mcp": {
      "type": "stdio",
      "command": "C:/Users/abrah/AppData/Local/RvtMcp/rvt/server/0.5.0/rvt-mcp.exe"
    },
    "revit-mcp-shuotao": {
      "type": "stdio",
      "command": "node",
      "args": ["C:/Users/abrah/REVIT_MCP_study/MCP-Server/build/index.js"]
    }
  }
}

📋 Lưu ý quan trọng

• Chỉ 1 MCP kết nối Revit tại 1 thời điểm (shuotao giữ lock port 8964, bimwright dùng Named Pipe riêng)
• Cần mở Revit và bật MCP service từ ribbon trước khi dùng
• Cần khởi động lại VS Code sau khi thêm MCP server mới

📊 Báo cáo Audit

Xem báo cáo audit chi tiết dự án Swan Lake Villa trong thư mục audit/:

• audit-report.pdf - Báo cáo PDF
• audit-report.html - Báo cáo HTML (chỉnh sửa được)

🔧 Phát triển

Để code/update, mở thư mục tương ứng và build:

• mcp-servers-for-revit/ → dotnet build (plugin) + npm run build (server)
• rvt-mcp/ → dotnet build (xem docs/ARCHITECTURE.md)
• REVIT_MCP_study/ → dotnet build -c Release.R26 (plugin) + npm run build (server)

📄 License

Apache 2.0