O que é um servidor MCP de IFC?

Um pequeno programa que dá a um assistente de IA ferramentas para arquivos IFC por meio do Model Context Protocol. Este permite que o Claude ou qualquer cliente MCP valide um modelo, verifique-o com um IDS, leia pranchas DXF e abra modelos, pranchas, esboços e gêmeos digitais em um visualizador 3D no navegador.

Sim. É código aberto sob licença MIT, não precisa de conta nem de chave de API e roda com npx. O visualizador 3D para o qual ele aponta também é gratuito.

Meus arquivos IFC são enviados para a internet?

Não. A validação, o IDS e a leitura de DXF rodam em Node.js no seu computador, com o mesmo motor do visualizador do navegador. Só a ferramenta FIWARE se comunica com o exterior, e apenas com o broker que você indicar.

Com quais clientes funciona?

Com qualquer cliente que rode servidores MCP locais via stdio: Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, Cline e outros. Todos usam o mesmo comando: npx -y ifc-viewer-mcp.

O Claude consegue abrir meu IFC local no visualizador 3D?

Não diretamente. O navegador precisa baixar o arquivo, então o link do visualizador exige uma URL pública. Com um arquivo local, o Claude o valida no seu computador e você arrasta o arquivo para a página do visualizador para ver as ocorrências em 3D.

O Health Score é o mesmo do site?

Sim. Ele inclui o validador e o cálculo de nota do próprio visualizador, então a nota, a contagem de ocorrências e os guias de correção batem com o que o navegador mostra para o mesmo arquivo e as mesmas regras.

Voltar ao blog de BIM e IFC

Ferramentas e comparativos · 2026-11-02 · 6 min

Um servidor MCP de IFC para o Claude: valide modelos BIM e abra-os em 3D

Pergunte ao Claude se um modelo está pronto para entrega e receba uma resposta com nota, os elementos com falha e um link para vê-los em 3D. As verificações rodam no seu próprio computador.

Modelo IFC de um edifício no visualizador 3D do navegador com seu Health Score e as ocorrências de validação, aberto a partir de um link criado por um assistente de IA

O Model Context Protocol (MCP) permite que um assistente de IA chame ferramentas no seu computador. O servidor MCP do IFC Viewer Online dá ao Claude e a outros assistentes dez ferramentas para o trabalho BIM: validar um IFC e dar uma nota, verificá-lo com um IDS, ler um DXF e abrir modelos, pranchas, esboços 3D e gêmeos digitais ao vivo em um visualizador 3D gratuito no navegador.

O essencial

Instala com um comando: npx -y ifc-viewer-mcp. Gratuito, MIT, sem conta.
Validação, IDS e DXF rodam no seu computador; os arquivos não são enviados.
O mesmo Health Score e as mesmas regras do visualizador do navegador, com links para guias de correção.
Os links abrem modelos, pranchas, esboços e gêmeos urbanos em 3D, prontos para compartilhar ou incorporar.

Como instalo o servidor MCP de IFC?

Você precisa do Node.js 20 ou mais recente. Todos os clientes iniciam o servidor com o mesmo comando, npx -y ifc-viewer-mcp, que o baixa na primeira vez.

Claude Code Rode claude mcp add ifc-viewer -- npx -y ifc-viewer-mcp em um terminal. As ferramentas aparecem na próxima sessão.
Claude Desktop Abra Settings, depois Developer, depois Edit config, e adicione o bloco abaixo ao claude_desktop_config.json. Reinicie o Claude.
Cursor, VS Code, Windsurf, Cline Adicione um servidor com o comando npx e os argumentos -y e ifc-viewer-mcp nas configurações MCP do cliente. O JSON é o mesmo.

{
  "mcpServers": {
    "ifc-viewer": { "command": "npx", "args": ["-y", "ifc-viewer-mcp"] }
  }
}

Quais ferramentas ele dá ao Claude?

Ferramenta	O que retorna	Onde roda
validate_ifc	Health Score 0–100, contagem de ocorrências, regras que mais pesam, ocorrências com guias de correção	Seu computador
list_validation_rules	Cada regra com categoria, gravidade e norma	Seu computador
check_ids	Aprovado ou reprovado por especificação IDS, com os elementos que falham	Seu computador
open_in_3d_viewer	Link do visualizador e um iframe para incorporar	Navegador
open_drawings	Modelo com uma planta cortada ao lado	Navegador
read_dxf	Camadas, número de entidades, extensão, unidades e textos	Seu computador
open_3d_sketch	O estúdio de esboços 3D	Navegador
list_digital_twins	Gêmeos urbanos ao vivo e o criador de gêmeos	Navegador
read_fiware_entities	Entidades de um broker FIWARE como registros planos	Do seu computador ao broker
search_port_library	Objetos IFC do Port de Barcelona com links 3D	Seu computador

Como valido um arquivo IFC com o Claude?

Dê ao Claude um caminho ou uma URL e pergunte. validate_ifc aplica o conjunto de regras do visualizador — esquema, estrutura espacial, nomes, GlobalIds, ISO 19650, classificação, instalações (MEP) — e retorna o Health Score com o que mais tirou pontos.

Validate C:/projects/duplex/ARC.ifc and tell me the three things that cost the most points.

No exemplo Duplex, ele retorna um Health Score de 77 com 168 ocorrências, lideradas por 119 elementos sem tipo, 21 ambientes sem área e 12 elementos sem material, cada uma com um link para o seu guia de correção. Um modelo com URL pública recebe também um link que o abre no visualizador com as mesmas ocorrências.

Modelo IFC Duplex no visualizador 3D com o selo do Health Score e o painel de validação listando as ocorrências por regra — O link de validate_ifc ou open_in_3d_viewer: o mesmo modelo, a mesma nota e as mesmas ocorrências no navegador.

Ele verifica um modelo com requisitos IDS?

Sim. check_ids recebe o IFC e um arquivo .ids (um caminho, uma URL ou o próprio XML) e retorna, para cada especificação, se foi atendida, quantos elementos se aplicam e quais falham e por quê. Usa o mesmo motor IDS 1.0 do visualizador do navegador; veja o guia de IDS.

Check model.ifc against requirements.ids and list the walls that fail, with their GlobalId.

Como abro um modelo em 3D a partir de um chat?

Peça. open_in_3d_viewer monta um link com as opções que você citar: vários modelos como uma cena federada, posicionados no mapa da cidade, vistos de cima, com uma classe IFC isolada ou uma nuvem de pontos ao lado. Também retorna um iframe para uma wiki, uma intranet ou um painel.

Open https://example.com/site/ARC.ifc and STR.ifc on the map, seen from the top, and give me an embed for our wiki.

Ele trabalha com pranchas técnicas?

De duas formas. read_dxf diz o que um DXF contém — camadas, número de entidades, tamanho em metros e os textos nele, como nomes de ambientes — sem abrir um programa de CAD. open_drawings abre o modelo com uma planta já cortada, onde você pode soltar um DXF ou um PDF, alinhá-lo e exportar DXF, SVG ou PDF, como explicado em abrir pranchas DXF e PDF ao lado de um modelo IFC.

What layers are in ground-floor.dxf, how big is it, and which rooms are labelled?

Modelo IFC em 3D ao lado de uma planta cortada do modelo no painel de pranchas — open_drawings: a planta é cortada do modelo quando a página abre.

Ele inicia um esboço 3D?

open_3d_sketch aponta para o estúdio de esboços, onde você desenha em 3D com caneta, dedo ou mouse e exporta SVG, PSD, ORA ou um script do Blender. Há um layout em dois painéis para dobráveis. Mais em desenhar em 3D online.

Estúdio de esboços 3D no navegador com traços desenhados no espaço em volta de uma grade — O estúdio de esboços para o qual open_3d_sketch aponta.

Quais ferramentas de gêmeo digital existem?

list_digital_twins retorna os gêmeos urbanos que vêm com o visualizador — Barcelona, Helsinque e dois em Tóquio —, cada um com um link e um link para incorporar, além do criador de gêmeos para o seu próprio armazém ou gêmeo de importações. read_fiware_entities lê um context broker FIWARE via NGSI-LD ou NGSIv2 e retorna registros planos, o formato que o painel do gêmeo vincula aos elementos IFC. search_port_library busca objetos na biblioteca IFC do Port de Barcelona, como guindastes e cabeços de amarração, com um link para ver cada um em 3D.

Show me a live digital twin of Barcelona, then find a crane in the Port de Barcelona library and open it in 3D.

Plaça de Catalunya, em Barcelona, como gêmeo digital 3D com edifícios IFC sobre o mapa da cidade e dados abertos ao vivo — A cena de Barcelona de list_digital_twins, com bicicletas, carregadores, trânsito e qualidade do ar ao vivo.

Modelo IFC de um guindaste do Port de Barcelona, da sua biblioteca BIM aberta, no visualizador 3D — Um guindaste de search_port_library (Port de Barcelona, CC BY 4.0).

O que ele não faz?

Não edita nem corrige arquivos IFC; aponta problemas e leva aos guias de correção.
Não envia nada nem guarda histórico; cada chamada começa do zero.
Não abre um arquivo local no visualizador do navegador; isso exige uma URL pública ou arrastar o arquivo.
Reconhece DWG, mas não o lê; salve-o antes como DXF.

Um servidor MCP de IFC para o Claude: valide modelos BIM e abra-os em 3D