Revit Model MCP
Trabalhe com modelos Autodesk Revit ao vivo a partir de qualquer cliente MCP, localmente ou em um PC Windows remoto via SSH: consulte, agregue, inspecione e atue com desfazer.
Documentação
Revit Model MCP
Para pessoas que revisam ou automatizam projetos Revit com um cliente MCP: leia e atue em um projeto Revit ativo por meio do MCP. As ações são habilitadas por padrão, e qualquer configuração somente leitura as desativa.
Política de privacidade
O Revit Model MCP retorna os dados do modelo solicitados ao cliente MCP selecionado. O pacote habilita a redação do caminho de resposta por padrão. A política de privacidade cobre coleta, armazenamento, compartilhamento, retenção e informações de contato.
Assinatura de código
As versões de lançamento ainda não são assinadas com código, então o Revit pergunta se deseja carregar o complemento após a instalação e após cada atualização.
Verifique os downloads com SHA256SUMS.txt e a atestação de proveniência da compilação; consulte assinatura de código.
Instalação
Pacote Claude Desktop
Instale uv no PATH do cliente, baixe revit-model-mcp-<version>.mcpb do último lançamento e abra-o no Claude Desktop.
O pacote inicia a partir do cache local do uv. O servidor verifica se há uma versão estável mais recente em segundo plano uma vez por dia.
A próxima inicialização do cliente usa a versão atualizada. Defina REVIT_MCP_NO_UPDATE_CHECK=1 para optar por não participar.
O formulário de configurações define o host da estação de trabalho, a redação de caminhos, as ações opcionais e o token de portador HTTP sem editar JSON.
Use local na estação de trabalho Windows com Revit, ou configure uma estação de trabalho remota para clientes macOS e Linux.
A redação de caminhos começa habilitada e as ações começam desabilitadas.
A estação de trabalho Windows ainda precisa do complemento abaixo.
Consulte o guia do pacote para detalhes de compilação e pré-requisitos.
Verifique os downloads. Os ativos de lançamento incluem atestações de proveniência da compilação do GitHub; siga a verificação de download antes de instalar.
Na estação de trabalho Revit
Baixe RevitModelMcp-<version>-SingleUser.msi (usuário atual) ou RevitModelMcp-<version>-MultiUser.msi (todos os usuários) do último lançamento.
Execute com o Revit fechado, depois inicie o Revit e abra um modelo.
Consulte atualizações automáticas para comportamento de atualização e configurações de exclusão.
Alternativamente, execute a partir de um clone no PowerShell:
.\install.ps1 -Source Release
Na máquina com o cliente MCP
Instale uv e use Python 3.11+. Para Claude Code na mesma estação de trabalho Windows:
claude mcp add revit-model-mcp -e REVIT_MCP_HOST=local -e REVIT_MCP_REDACT_PATHS=1 -- uvx revit-model-mcp
Para registro manual no Claude Desktop, adicione à sua configuração MCP:
{
"mcpServers": {
"revit-model-mcp": {
"command": "uvx",
"args": ["revit-model-mcp"],
"env": {
"REVIT_MCP_HOST": "local",
"REVIT_MCP_REDACT_PATHS": "1"
}
}
}
}
A partir de um clone, uv run --directory server revit-model-mcp executa o mesmo servidor sem instalar o pacote.
Com REVIT_MCP_HOST=local o servidor alcança cada Revit por meio de seu próprio pipe nomeado, restrito ao usuário Windows que executa o Revit; nenhuma reserva de porta ou URL é necessária.
Para clientes macOS ou Linux, configure uma estação de trabalho remota.
Verificação
Chame revit_ping no cliente MCP e espere success: true.
Em ação
O Claude Desktop roda em um Mac e se conecta ao Revit 2026 em uma estação de trabalho Windows. As ações estão habilitadas nesta gravação.
Se o Revit Model MCP economizar seu tempo, uma :star: no GitHub ajuda outros usuários do Revit a encontrá-lo.
O que acontece na gravação, em ordem:
- "Qual modelo está aberto no Revit agora?" O cliente lê o documento, os níveis e as contagens de salas.
- "Qual nível tem a maior área de sala? Encontre a maior sala e mostre-a para mim." O cliente agrega áreas de salas por nível e consulta a maior sala.
revit_showabre uma planta correspondente e seleciona a sala. - "Isole essa sala, coloque uma Cadeira-Breuer no centro e mova-a 800 mm ao longo de X."
revit_isolate, depoisrevit_place_familynoroomCenterMmda sala, depoisrevit_move. Cada mutação é sua própria transação do Revit. - A limpeza depois é mais uma frase: redefina a vista, exclua a cadeira.
A imagem abaixo é o PNG salvo por revit_export_view durante uma sessão anterior contra o Revit 2023 via SSH, sem alterações:
O que você obtém
| Ferramentas de leitura | Nomes |
|---|---|
| Documento e catálogo | revit_ping, revit_document_info, revit_list_catalog, revit_list_instances |
| Elementos e parâmetros | revit_query_elements, revit_aggregate_elements, revit_element_details, revit_list_relations, revit_list_warnings |
| Vistas e exportação | revit_list_views, revit_view_summary, revit_view_elements, revit_view_warnings, revit_export_view |
| Verificações de coordenação | revit_model_health, revit_links_status, revit_shared_coordinates, revit_parameter_fill_check |
Consulte a referência completa de ferramentas para argumentos, unidades e limites.
As ações são habilitadas por padrão: opte por não participar com REVIT_MCP_READ_ONLY=1 no servidor, ou o arquivo read-only da estação de trabalho.
As mutações de modelo suportam visualizações dry_run e retornam verification e um summary legível por humanos; uma ação confirmada é assimilada em uma única entrada de desfazer nomeada do Revit, visível no painel "Atividade MCP" do complemento; revit_undo_last desfaz enquanto ainda é a última alteração do Revit.
Consulte ações para portões, exceções e falhas de verificação.
Estações de trabalho remotas
Clientes Windows locais usam REVIT_MCP_HOST=local sob a conta do usuário do Revit.
Clientes remotos executam o servidor inteiro na estação de trabalho via SSH, como o mesmo usuário Windows que executa o Revit.
Instale lá uma vez com uv tool install revit-model-mcp, depois registre ssh como o comando:
{
"mcpServers": {
"revit-model-mcp": {
"command": "ssh",
"args": ["revit-pc", "revit-model-mcp", "--redact-paths"]
}
}
}
Substitua revit-pc pelo alias de host SSH da estação de trabalho.
O fluxo MCP stdio passa pela sessão SSH e o servidor remoto usa o pipe nomeado, então nenhuma porta é aberta.
REVIT_MCP_HOST=ssh:<alias> (canal de arquivo via SSH) e HTTP por um túnel SSH permanecem disponíveis; HTTP requer um token de portador, exceto para /health, e vincula ao loopback por padrão.
Consulte configuração de transporte.
Segurança
As ferramentas padrão leem o modelo sem transações que alteram o modelo; exportações e operações de canal escrevem arquivos fora dele.
As ações MCP são recusadas no modo somente leitura, enquanto chamadores HTTP diretos exigem o token de portador e são recusados enquanto o arquivo somente leitura da estação de trabalho estiver presente.
REVIT_MCP_REDACT_PATHS=1 oculta diretórios em campos de caminho de resposta, mas nomes, valores de parâmetros, erros, arquivos de canal e valores de localPath de imagem exportada permanecem visíveis.
Consulte detalhes de segurança para autenticação e limites de privacidade, e SECURITY.md para relatar uma vulnerabilidade.
Compatibilidade
| Ano do Revit | Estrutura de destino do complemento | Status de validação |
|---|---|---|
| 2022 | .NET Framework 4.8 | Evidência de compilação |
| 2023 | .NET Framework 4.8 | Evidência de compilação |
| 2024 | .NET Framework 4.8 | Compilações e script de instalação |
| 2025 | .NET 8 | Evidência de compilação |
| 2026 | .NET 8 | Compilações, leituras/ações ao vivo e script de instalação |
| 2027 | .NET 10 | Evidência de compilação |
Consulte evidência de validação para datas e limites, e lacunas conhecidas.
Contribuindo e suporte
A documentação cobre configuração, ferramentas e transporte.
Comece com CONTRIBUTING.md, faça perguntas em Discussões, ou relate bugs e solicite recursos por meio dos formulários de issue. O CI executa as suítes de teste C# e Python e compila as configurações suportadas do Revit.
Contribuidores
Licença
MIT, mantido por Dinar Sharafutdinov. Consulte avisos de terceiros para licenças de dependências.