{
  "markdown": "<div align=\"center\">\n\n<img src=\"assets/logo.svg\" alt=\"AEC Model Bridge\" height=\"120\">\n\n# AEC Model Bridge\n\nAEC Model Bridge is the open, secure runtime that puts Revit, Rhino, Navisworks, and Power BI behind one MCP call center — so an AI agent orchestrates them directly, instead of you manually dumping data between disconnected apps.\n\n\n\n[![MCP Registry](https://img.shields.io/badge/MCP_Registry-active-0F766E?style=flat-square)](https://registry.modelcontextprotocol.io/?q=io.github.Sam-AEC%2Faec-model-bridge)\n[![License](https://img.shields.io/badge/license-GPLv3%2B%20%2F%20Commercial-2563EB?style=flat-square)](LICENSING.md)\n[![Python](https://img.shields.io/badge/Python-3.11+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)\n[![Revit](https://img.shields.io/badge/Revit-2024--2027-0696D7?style=flat-square)](https://www.autodesk.com/products/revit/)\n\n<br>\n<strong>Available now</strong><br>\n\n![Revit available](https://img.shields.io/badge/Revit-available-16A34A?style=flat-square)\n![Rhino and Grasshopper available](https://img.shields.io/badge/Rhino_%2F_Grasshopper-available-16A34A?style=flat-square)\n![IfcOpenShell available](https://img.shields.io/badge/IfcOpenShell-available-16A34A?style=flat-square)\n![Speckle available](https://img.shields.io/badge/Speckle-available-16A34A?style=flat-square)\n\n<strong>In progress</strong><br>\n\n![Navisworks Manage in progress](https://img.shields.io/badge/Navisworks_Manage-in_progress-F59E0B?style=flat-square)\n![Power BI in progress](https://img.shields.io/badge/Power_BI-in_progress-F59E0B?style=flat-square)\n\n<strong>Coming soon</strong><br>\n\n![Microsoft Excel coming soon](https://img.shields.io/badge/Microsoft_Excel-coming_soon-2563EB?style=flat-square)\n![Parquet and DuckDB coming soon](https://img.shields.io/badge/Parquet_%2F_DuckDB-coming_soon-2563EB?style=flat-square)\n\n[Install](#installation) | [Tools](docs/tools-generated.md) | [Documentation](#documentation) | [Latest release](https://github.com/Sam-AEC/aec-model-bridge/releases/latest)\n\n</div>\n\nA single MCP client — Claude Desktop, VS Code, GitHub Copilot, or a custom\nagent — talks to one Python hub, and the hub routes each call to whichever\napp the task actually needs: draw geometry in Rhino, query parameters in\nRevit, resolve clashes in Navisworks, publish a dashboard to Power BI. The\nagent plans the workflow once; the bridge is what lets it reach every app\nwithout you being the one copying data between them.\n\nThe Python hub handles MCP communication and routes each request to the relevant\ndesktop, headless, cloud, or compute provider:\n- **Revit**: Native C# add-in (Revit 2024-2027) executing on the main thread via `ExternalEvent`.\n- **Navisworks Manage**: Native C# add-in (Navisworks 2024-2027) exposing the API over a local bridge (in progress).\n- **Rhino/Grasshopper**: Connects to the Rhino Bridge Add-in over HTTP localhost:3004.\n- **Speckle**: Native Python provider integrating Specklepy V3 for seamless model pushing to Power BI.\n- **IfcOpenShell**: Headless IFC semantic extraction and parsing.\n\n## Platform Status\n\nThe status below reflects the AEC Model Bridge system blueprint as of June 2026.\nIn-progress integrations are implemented as routing infrastructure but require further registration or workflow integration.\n\n### Available Now\n\nRevit, Rhino/Grasshopper, IfcOpenShell, and Speckle are available integrations. The Revit C# add-in (Revit 2024-2027) executes commands on the main thread. Rhino connects to the Rhino Bridge Add-in over HTTP on port 3004. IfcOpenShell provides headless IFC parsing, and Speckle integrates model pushing via Specklepy V3.\n\n### In Progress\n\nNavisworks Manage is currently in progress; while the C# add-in routing infrastructure is in place, the provider is not yet registered in the shipped hub. Power BI is also in progress, with the provider and tool in place but not yet integrated into the active hub runtime.\n\n### Coming Soon\n\nThis wave adds Excel workbook round trips and a Parquet/DuckDB data plane for cross-platform reporting.\n\n## Highlights\n\n- 100+ MCP tools for model authoring, documentation, parameters, views, sheets, exports, and QA.\n- Native Revit & Navisworks add-ins with no Dynamo or pyRevit dependencies.\n- Multi-platform synchronization: Cross-query Navisworks clash results, Revit parameters, and Rhino models dynamically.\n- Speckle and PowerBI automated data handoffs.\n- Async job orchestration and centralized PII redaction.\n- Reflection and in-process Python for advanced API workflows.\n- Localhost-only bridge by default for absolute security.\n- Mock mode for development and automated testing without Revit.\n\n## How It Works\n\n```text\nMCP Client (Claude Desktop, VS Code)\n    |\n    | MCP over stdio\n    v\n    Python MCP Server (Central Router)\n        ├── [Revit Provider] -----> HTTP localhost:3000 -----> Revit Bridge Add-in\n        ├── [Navisworks Provider] > HTTP localhost:3002 -----> Navisworks Bridge Add-in\n        ├── [Speckle Provider] ---> HTTPS (OAuth) -----------> Speckle Manager / Power BI\n        ├── [Rhino Provider] -----> HTTP localhost:3004 -----> Rhino Bridge Add-in\n        └── [IFC Provider] -------> Local Filesystem --------> IfcOpenShell\n```\n\n## Installation\n\n### Requirements\n\n| Revit version | Add-in target | Required build tools |\n|---|---|---|\n| 2024 | .NET Framework 4.8 | .NET 8 SDK and .NET Framework 4.8 developer pack |\n| 2025 | .NET 8 for Windows | .NET 8 SDK |\n| 2026 | .NET 8 for Windows | .NET 8 SDK |\n| 2027 | .NET 10 for Windows | .NET 10 SDK |\n\nYou also need Windows 10 or 11, Python 3.11 or later, and a licensed Revit\ninstallation for the version you want to use.\n\n### 1. Install the MCP server\n\n```powershell\ngit clone https://github.com/Sam-AEC/aec-model-bridge.git\ncd aec-model-bridge\n\npy -m venv .venv\n.\\.venv\\Scripts\\Activate.ps1\npython -m pip install -e packages/mcp-server-revit\n```\n\n### 2. Install the Revit add-in\n\nSet the version to match your Revit installation:\n\n```powershell\n$RevitVersion = Read-Host \"Revit year (2024, 2025, 2026, or 2027)\"\n\n.\\scripts\\package.ps1 -RevitVersion $RevitVersion\n.\\scripts\\install.ps1 -RevitVersion $RevitVersion\n```\n\nThe installer places version-specific binaries in:\n\n```text\nC:\\ProgramData\\AECModelBridge\\bin\\<year>\n```\n\nThe add-in manifest is installed per user in:\n\n```text\n%APPDATA%\\Autodesk\\Revit\\Addins\\<year>\n```\n\nUse `-AllUsers` with `install.ps1` to install the manifest under\n`C:\\ProgramData\\Autodesk\\Revit\\Addins\\<year>` instead.\n\nTo prepare binaries for every supported version in one pass:\n\n```powershell\n.\\scripts\\package.ps1 -RevitVersion All\n```\n\nPrebuilt packages are attached to GitHub releases when available. The source\ninstallation above is the canonical path for all supported Revit versions.\n\n### 3. Configure your MCP client\n\nUse the Python executable from the virtual environment and choose a workspace\nthat the server may access:\n\n```json\n{\n  \"mcpServers\": {\n    \"aec-model-bridge\": {\n      \"command\": \"C:\\\\path\\\\to\\\\aec-model-bridge\\\\.venv\\\\Scripts\\\\python.exe\",\n      \"args\": [\"-m\", \"revit_mcp_server.mcp_server\"],\n      \"env\": {\n        \"MCP_REVIT_MODE\": \"bridge\",\n        \"MCP_REVIT_BRIDGE_URL\": \"http://127.0.0.1:3000\",\n        \"MCP_REVIT_WORKSPACE_DIR\": \"C:\\\\RevitProjects\",\n        \"MCP_REVIT_ALLOWED_DIRECTORIES\": \"C:\\\\RevitProjects\"\n      }\n    }\n  }\n}\n```\n\nVS Code users can start from [`.vscode/mcp.json`](.vscode/mcp.json).\n\nClients that support MCP Bundles can install the `.mcpb` file from the\n[latest release](https://github.com/Sam-AEC/aec-model-bridge/releases/latest).\nThe Revit add-in is still required because the MCP server communicates with the\nrunning desktop application.\n\n### 4. Verify the connection\n\nRestart Revit after installing the add-in, open a model, and run:\n\n```powershell\nInvoke-RestMethod http://127.0.0.1:3000/health\n```\n\nThe response should report `healthy` and the active Revit version.\n\n## Revit API Access\n\nThe typed MCP tools cover the common workflow surface and are the recommended\ndefault for agents.\n\nFor work outside the tool catalog, `invoke_method`, `reflect_get`, and\n`reflect_set` can work with public .NET API members. `execute_python` runs\nIronPython inside Revit with `doc`, `uidoc`, `uiapp`, and `app` available.\n\nThese advanced tools run with the same permissions as the Revit process. Keep\nthe bridge on localhost and only use trusted MCP clients and prompts.\n\n## Development\n\n```powershell\n# Python tests\npython -m pytest packages/mcp-server-revit/tests\n\n# Build one Revit version\n$RevitVersion = Read-Host \"Revit year (2024, 2025, 2026, or 2027)\"\n.\\scripts\\build-addin.ps1 -RevitVersion $RevitVersion -Configuration Release\n\n# Build all supported versions\n.\\scripts\\package.ps1 -RevitVersion All\n```\n\nCI builds the Python server and add-in targets for Revit 2024 through 2027.\n\n## Documentation\n\n- [Installation guide](docs/install.md)\n- [Tool reference](docs/tools-generated.md)\n- [Architecture](docs/0001-multi-provider-architecture.md)\n- [Configuration reference](docs/configuration-reference.md)\n- [Security](docs/security.md)\n- [MCP clients and registry](docs/marketplaces.md)\n- [Contributing](CONTRIBUTING.md)\n\n## Project\n\nMaintained by [A. Sam Mohammad](https://github.com/Sam-AEC).\n[LinkedIn](https://www.linkedin.com/in/a-sam-mohammad-92790416b) |\n[Issues](https://github.com/Sam-AEC/aec-model-bridge/issues)\n\nVersion 1.1.0 and later is available under your choice of\n[GPL-3.0-or-later with the Revit Linking Exception, or a separate commercial\nlicense](LICENSING.md). The GPL option permits community use while allowing the\nadd-in to operate through Autodesk Revit APIs. Commercial terms are available\nfor proprietary distribution and negotiated requirements. Version 1.0.2 and\nearlier remains available under the MIT License.\n\nAEC Model Bridge is an independent project and is not sponsored, endorsed, or\nprovided by Autodesk. Autodesk and Revit are trademarks of the Autodesk group\nof companies. See [TRADEMARKS.md](TRADEMARKS.md).\n",
  "bytes": 9966,
  "sha": "2de2b0ba193ba32b38023bb187d7f2437c1d58f9a09c6d957368a1e2fce56749",
  "repo_slug": "sam-aec/aec-model-bridge",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_sam_aec_aec_model_bridge_ed49909b/readme"
}