Autodesk Revit MCP Server

Um único cliente MCP — Claude Desktop, VS Code, GitHub Copilot ou um agente personalizado — conversa com um hub Python, e o hub roteia cada chamada para o aplicativo que a tarefa realmente precisa: desenhar geometria no Rhino, consultar parâmetros no Revit, resolver conflitos no Navisworks, publicar um dashboard no Power BI. O agente planeja o fluxo de trabalho uma vez; a ponte é o que permite alcançar cada aplicativo sem que você seja quem copia dados entre eles.

O hub Python gerencia a comunicação MCP e roteia cada solicitação para o provedor relevante de desktop, headless, nuvem ou computação:

• Revit: Add-in nativo em C# (Revit 2024-2027) executando na thread principal via ExternalEvent.
• Navisworks Manage: Add-in nativo em C# (Navisworks 2024-2027) expondo a API por uma ponte local (em andamento).
• Rhino/Grasshopper: Conecta-se ao Rhino Bridge Add-in via HTTP localhost:3004.
• Speckle: Provedor nativo em Python integrando Specklepy V3 para envio contínuo de modelos ao Power BI.
• IfcOpenShell: Extração e análise semântica headless de IFC.

Status da Plataforma

O status abaixo reflete o blueprint do sistema AEC Model Bridge em junho de 2026. Integrações em andamento são implementadas como infraestrutura de roteamento, mas exigem registro adicional ou integração de fluxo de trabalho.

Disponível Agora

Revit, Rhino/Grasshopper, IfcOpenShell e Speckle são integrações disponíveis. O add-in C# do Revit (Revit 2024-2027) executa comandos na thread principal. O Rhino conecta-se ao Rhino Bridge Add-in via HTTP na porta 3004. O IfcOpenShell fornece análise headless de IFC, e o Speckle integra o envio de modelos via Specklepy V3.

Em Andamento

O Navisworks Manage está atualmente em andamento; embora a infraestrutura de roteamento do add-in C# esteja implementada, o provedor ainda não está registrado no hub distribuído. O Power BI também está em andamento, com o provedor e a ferramenta implementados, mas ainda não integrados ao runtime ativo do hub.

Em Breve

Esta onda adiciona idas e voltas de pastas de trabalho do Excel e um plano de dados Parquet/DuckDB para relatórios entre plataformas.

Destaques

• Mais de 100 ferramentas MCP para criação de modelos, documentação, parâmetros, vistas, folhas, exportações e QA.
• Add-ins nativos para Revit e Navisworks sem dependências de Dynamo ou pyRevit.
• Sincronização multiplataforma: consulte dinamicamente resultados de conflitos do Navisworks, parâmetros do Revit e modelos do Rhino.
• Transferências automatizadas de dados com Speckle e PowerBI.
• Orquestração assíncrona de trabalhos e centralização da redação de PII.
• Reflexão e Python em processo para fluxos de trabalho avançados de API.
• Ponte somente em localhost por padrão para segurança absoluta.
• Modo simulado para desenvolvimento e testes automatizados sem Revit.

Como Funciona

MCP Client (Claude Desktop, VS Code)
    |
    | MCP over stdio
    v
    Python MCP Server (Central Router)
        ├── [Revit Provider] -----> HTTP localhost:3000 -----> Revit Bridge Add-in
        ├── [Navisworks Provider] > HTTP localhost:3002 -----> Navisworks Bridge Add-in
        ├── [Speckle Provider] ---> HTTPS (OAuth) -----------> Speckle Manager / Power BI
        ├── [Rhino Provider] -----> HTTP localhost:3004 -----> Rhino Bridge Add-in
        └── [IFC Provider] -------> Local Filesystem --------> IfcOpenShell

Instalação

Requisitos

Versão do Revit	Alvo do add-in	Ferramentas de build necessárias
2024	.NET Framework 4.8	.NET 8 SDK e pacote de desenvolvedor .NET Framework 4.8
2025	.NET 8 para Windows	.NET 8 SDK
2026	.NET 8 para Windows	.NET 8 SDK
2027	.NET 10 para Windows	.NET 10 SDK

Você também precisa de Windows 10 ou 11, Python 3.11 ou posterior, e uma instalação licenciada do Revit para a versão que deseja usar.

1. Instale o servidor MCP

git clone https://github.com/Sam-AEC/aec-model-bridge.git
cd aec-model-bridge

py -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -e packages/mcp-server-revit

2. Instale o add-in do Revit

Defina a versão para corresponder à sua instalação do Revit:

$RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"

.\scripts\package.ps1 -RevitVersion $RevitVersion
.\scripts\install.ps1 -RevitVersion $RevitVersion

O instalador coloca os binários específicos da versão em:

C:\ProgramData\AECModelBridge\bin\<year>

O manifesto do add-in é instalado por usuário em:

%APPDATA%\Autodesk\Revit\Addins\<year>

Use -AllUsers com install.ps1 para instalar o manifesto em C:\ProgramData\Autodesk\Revit\Addins\<year>.

Para preparar os binários para todas as versões suportadas de uma só vez:

.\scripts\package.ps1 -RevitVersion All

Pacotes pré-compilados são anexados aos lançamentos do GitHub quando disponíveis. A instalação a partir do código-fonte acima é o caminho canônico para todas as versões suportadas do Revit.

3. Configure seu cliente MCP

Use o executável Python do ambiente virtual e escolha um espaço de trabalho que o servidor possa acessar:

{
  "mcpServers": {
    "aec-model-bridge": {
      "command": "C:\\path\\to\\aec-model-bridge\\.venv\\Scripts\\python.exe",
      "args": ["-m", "revit_mcp_server.mcp_server"],
      "env": {
        "MCP_REVIT_MODE": "bridge",
        "MCP_REVIT_BRIDGE_URL": "http://127.0.0.1:3000",
        "MCP_REVIT_WORKSPACE_DIR": "C:\\RevitProjects",
        "MCP_REVIT_ALLOWED_DIRECTORIES": "C:\\RevitProjects"
      }
    }
  }
}

Usuários do VS Code podem começar por .vscode/mcp.json.

Clientes que suportam MCP Bundles podem instalar o arquivo .mcpb do último lançamento. O add-in do Revit ainda é necessário porque o servidor MCP se comunica com o aplicativo desktop em execução.

4. Verifique a conexão

Reinicie o Revit após instalar o add-in, abra um modelo e execute:

Invoke-RestMethod http://127.0.0.1:3000/health

A resposta deve informar healthy e a versão ativa do Revit.

Acesso à API do Revit

As ferramentas MCP tipadas cobrem a superfície de fluxo de trabalho comum e são a opção padrão recomendada para agentes.

Para trabalho fora do catálogo de ferramentas, invoke_method, reflect_get e reflect_set podem trabalhar com membros públicos da API .NET. execute_python executa IronPython dentro do Revit com doc, uidoc, uiapp e app disponíveis.

Essas ferramentas avançadas são executadas com as mesmas permissões do processo do Revit. Mantenha a ponte em localhost e use apenas clientes e prompts MCP confiáveis.

Desenvolvimento

# Python tests
python -m pytest packages/mcp-server-revit/tests

# Build one Revit version
$RevitVersion = Read-Host "Revit year (2024, 2025, 2026, or 2027)"
.\scripts\build-addin.ps1 -RevitVersion $RevitVersion -Configuration Release

# Build all supported versions
.\scripts\package.ps1 -RevitVersion All

O CI compila o servidor Python e os alvos de add-in para Revit 2024 a 2027.

Documentação

• Guia de instalação
• Referência de ferramentas
• Arquitetura
• Referência de configuração
• Segurança
• Clientes MCP e registro
• Contribuindo

Projeto

Mantido por A. Sam Mohammad. LinkedIn | Issues

A versão 1.1.0 e posteriores está disponível sob sua escolha de GPL-3.0-or-later com a Exceção de Vinculação do Revit, ou uma licença comercial separada. A opção GPL permite uso comunitário enquanto permite que o add-in opere por meio das APIs do Autodesk Revit. Termos comerciais estão disponíveis para distribuição proprietária e requisitos negociados. A versão 1.0.2 e anteriores permanece disponível sob a Licença MIT.

AEC Model Bridge é um projeto independente e não é patrocinado, endossado ou fornecido pela Autodesk. Autodesk e Revit são marcas registradas do grupo de empresas Autodesk. Consulte TRADEMARKS.md.