返回 BIM 与 IFC 博客
Model Context Protocol（MCP）让 AI 助手可以调用你电脑上的工具。IFC Viewer Online 的 MCP 服务器为 Claude 和其他助手提供十个 BIM 工具：校验 IFC 并评分、按 IDS 检查、读取 DXF，以及在免费的浏览器 3D 查看器中打开模型、图纸、3D 草图和实时数字孪生。
要点
- 一条命令安装：npx -y ifc-viewer-mcp。免费、MIT 许可、无需账号。
- 校验、IDS 和 DXF 在你的电脑上运行，文件不会上传。
- 与浏览器查看器相同的 Health Score 和规则，并附修复指南链接。
- 链接可在 3D 中打开模型、图纸、草图和城市孪生，可直接分享或嵌入。
如何安装 IFC MCP 服务器？
需要 Node.js 20 或更高版本。所有客户端都用同一条命令 npx -y ifc-viewer-mcp 启动服务器，首次运行时会自动下载。
- Claude Code 在终端运行 claude mcp add ifc-viewer -- npx -y ifc-viewer-mcp。下次会话即可使用这些工具。
- Claude Desktop 依次打开 Settings、Developer、Edit config，把下面的代码块加入 claude_desktop_config.json，然后重启 Claude。
- Cursor、VS Code、Windsurf、Cline 在客户端的 MCP 设置中添加一个服务器，命令为 npx，参数为 -y 和 ifc-viewer-mcp。JSON 相同。
{
"mcpServers": {
"ifc-viewer": { "command": "npx", "args": ["-y", "ifc-viewer-mcp"] }
}
}
它为 Claude 提供哪些工具？
| 工具 | 返回内容 | 运行位置 |
|---|
| validate_ifc | Health Score 0–100、问题数量、扣分最多的规则、附修复指南的问题 | 你的电脑 |
| list_validation_rules | 每条规则及其类别、严重程度和标准 | 你的电脑 |
| check_ids | 每项 IDS 规范是否通过，以及不合格的构件 | 你的电脑 |
| open_in_3d_viewer | 查看器链接和可嵌入的 iframe | 浏览器 |
| open_drawings | 模型及旁边剖切出的平面图 | 浏览器 |
| read_dxf | 图层、图元数量、范围、单位和文字 | 你的电脑 |
| open_3d_sketch | 3D 草图工作室 | 浏览器 |
| list_digital_twins | 实时城市孪生和孪生构建器 | 浏览器 |
| read_fiware_entities | FIWARE broker 实体，转换为扁平记录 | 从你的电脑到 broker |
| search_port_library | 巴塞罗那港 IFC 构件及 3D 链接 | 你的电脑 |
如何用 Claude 校验 IFC 文件？
给 Claude 一个路径或 URL 并提问即可。validate_ifc 运行查看器的规则集（模式、空间结构、名称、GlobalId、ISO 19650、分类、机电），返回 Health Score 以及扣分最多的项目。
Validate C:/projects/duplex/ARC.ifc and tell me the three things that cost the most points.
以 Duplex 示例为例，返回的 Health Score 为 77，共 168 个问题，排在前面的是 119 个没有类型的构件、21 个没有面积的空间和 12 个没有材质的构件，每项都附有修复指南链接。有公开 URL 的模型还会得到一个链接，在查看器中打开时显示同样的问题。
validate_ifc 或 open_in_3d_viewer 生成的链接：浏览器中是同一个模型、同样的评分和问题。
它能按 IDS 要求检查模型吗？
能。check_ids 接收 IFC 和一个 .ids 文件（路径、URL 或 XML 文本本身），针对每项规范返回是否通过、适用多少构件、哪些不合格及原因。它使用与浏览器查看器相同的 IDS 1.0 引擎，详见 IDS 指南。
Check model.ifc against requirements.ids and list the walls that fail, with their GlobalId.
如何在对话中用 3D 打开模型？
直接提出即可。open_in_3d_viewer 会按你说的选项生成链接：多个模型合成一个联合场景、放到城市地图上、从顶部查看、隔离某个 IFC 类或同时加载点云。它还会返回一个 iframe，可用于 wiki、内网或看板。
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.
它能处理技术图纸吗？
有两种方式。read_dxf 无需打开 CAD 软件就能告诉你 DXF 里有什么：图层、图元数量、以米为单位的尺寸以及图上的文字（例如房间名称）。open_drawings 会打开模型并附上已从模型剖切出的平面图，你可以在其中放入 DXF 或 PDF、对齐，并导出 DXF、SVG 或 PDF，详见 在 IFC 模型旁打开 DXF 和 PDF 图纸。
What layers are in ground-floor.dxf, how big is it, and which rooms are labelled?
open_drawings：页面打开时即从模型剖切出平面图。
它能开始一个 3D 草图吗？
open_3d_sketch 链接到草图工作室，你可以用手写笔、手指或鼠标在 3D 中绘图，并导出 SVG、PSD、ORA 或 Blender 脚本。它还为折叠屏提供双栏布局。更多内容见 在线 3D 绘图。
open_3d_sketch 链接到的草图工作室。
有哪些数字孪生工具？
list_digital_twins 返回查看器自带的城市孪生（巴塞罗那、赫尔辛基和东京的两个场景），每个都附带链接和嵌入链接，另外还有用于构建你自己的仓库或进口孪生的孪生构建器。read_fiware_entities 通过 NGSI-LD 或 NGSIv2 读取 FIWARE context broker，并返回扁平记录，也就是孪生面板绑定到 IFC 构件时使用的格式。search_port_library 在巴塞罗那港 IFC 库中搜索构件，例如起重机和系船柱，并为每个构件提供 3D 查看链接。
Show me a live digital twin of Barcelona, then find a crane in the Port de Barcelona library and open it in 3D.
list_digital_twins 中的巴塞罗那场景，包含实时的共享单车、充电桩、交通和空气质量。
search_port_library 找到的起重机（Port de Barcelona，CC BY 4.0）。
它不能做什么？
- 它不编辑也不修复 IFC 文件，只报告问题并链接到修复指南。
- 它不上传任何内容，也不保留历史；每次调用都从头开始。
- 它无法在浏览器查看器中打开本地文件；这需要公开 URL 或拖放文件。
- 能识别 DWG 但不能读取；请先另存为 DXF。
面向 Claude 的 IFC MCP 服务器：校验 BIM 模型并在 3D 中打开