scanbim

ScanBIM MCP — 面向 AEC 的 AI 中枢

让 Claude、ChatGPT 和任何 AI Agent 都能上传、转换、查看、分析和分享 50 多种格式的 BIM 模型。

上传一个 .rvt 文件，即可获得带二维码、可分享的 3D 查看器链接。利用 20 年的 VDC 智能技术进行碰撞检测。创建 RFI。启动 VR 漫游。无需安装软件。

---

生态系统（5 个 Worker，46 个工具）

| Worker | Version | Tools | Endpoint | Description |

|--------|---------|-------|----------|-------------|

| scanbim-mcp | v1.0.5 | 19 | /mcp | 核心中枢 — 模型、碰撞、ACC、XR、查看器、渲染 |

| revit-mcp | v1.1.0 | 8 | /mcp | Revit — 构件、参数、明细表、图纸、IFC 导出 |

| acc-mcp | v1.0.1 | 9 | /mcp | ACC/BIM 360 — 问题、RFI、文档、项目摘要 |

| navisworks-mcp | v1.1.0 | 5 | /mcp | Navisworks — 碰撞检测、协调、视点 |

| twinmotion-mcp | v1.1.0 | 5 | /mcp | 可视化 — 渲染、环境、视频、场景 |

全部 46 个工具都会实际调用 Autodesk Platform Services API。 没有任何空壳工具。已于 2026 年 4 月 12 日验证。

---

scanbim-mcp 工具（19 个）

| Tool | Description |

|------|-------------|

| upload_model | 通过 APS OSS + SVF2 转换上传 3D 模型（Revit、IFC、点云及 50 多种格式） |

| detect_clashes | 使用 D1 规则数据库（SMACNA、NEC、ACI 318）进行 VDC 级碰撞检测 |

| get_viewer_link | 为任何已转换的模型生成 APS Viewer URL + 二维码 |

| list_models | 列出 APS 存储桶中上传的所有模型 |

| get_model_metadata | 获取 APS 转换状态、清单和元数据 |

| get_supported_formats | 按层级（免费/专业/企业）列出支持的文件格式 |

| acc_list_projects | 列出 ACC/BIM 360 中心和项目 |

| acc_create_issue | 创建 ACC 问题，并设置优先级、负责人和截止日期 |

| acc_list_issues | 按状态和优先级列出/筛选 ACC 问题 |

| acc_create_rfi | 创建 ACC RFI |

| acc_list_rfis | 列出/筛选 ACC RFI |

| acc_search_documents | 按关键词搜索 ACC 项目文档 |

| acc_project_summary | 获取项目概览及问题/RFI 数量 |

| xr_launch_vr_session | 启动 VR 查看会话（Meta Quest 2/3/3S） |

| xr_launch_ar_session | 启动 AR 叠加会话 |

| xr_list_sessions | 列出活跃的 XR 会话 |

| twinmotion_render | 通过 APS 生成照片级真实感渲染图 |

| twinmotion_walkthrough | 创建动画漫游序列 |

| lumion_render | 建筑可视化渲染 |

revit-mcp 工具（8 个）

| Tool | Description |

|------|-------------|

| revit_upload | 将 .rvt 文件上传到 APS 并进行 SVF2 转换 |

| revit_get_elements | 按类别提取构件（墙、门、窗等） |

| revit_get_parameters | 获取构件参数并提取参数组 |

| revit_run_schedule | 从模型属性中提取表格明细数据 |

| revit_clash_detect | 包围盒重叠 + 楼层邻近度 + D1 VDC 规则 |

| revit_export_ifc | Model Derivative IFC 转换任务 |

| revit_get_sheets | 列出 2D 视图 + 图纸 |

| revit_get_views | 列出所有带详细级别的元数据视图 |

acc-mcp 工具（9 个）

工具	描述
acc_list_projects	列出所有 ACC/BIM 360 集线器和项目
acc_create_issue	创建质量/安全问题
acc_update_issue	更新问题状态、优先级和分配情况
acc_list_issues	按状态和优先级列出/筛选问题
acc_create_rfi	创建 RFI，并设置分配对象和优先级
acc_list_rfis	列出/筛选 RFI
acc_search_documents	跨项目全文搜索文档
acc_upload_file	通过 APS Data Management 上传文件（4 步流程）
acc_project_summary	项目仪表板，显示集线器/项目/问题/RFI 计数

navisworks-mcp 工具（5 个）

工具	描述
nwd_upload	上传 .nwd/.nwc 文件并进行 SVF2 转换
nwd_get_clashes	跨类别碰撞分析，包含楼层邻近度和 D1 VDC 规则
nwd_export_report	生成协调报告，并按类别细分
nwd_get_viewpoints	提取已保存的视点和相机位置
nwd_list_objects	按属性列出对象，并按关键词筛选

twinmotion-mcp 工具（5 个）

工具	描述
tm_import_rvt	通过 APS 导入 .rvt，并进行 SVF2 转换和缩略图转换
tm_set_environment	配置环境设置（时间、天气、季节）
tm_render_image	通过 APS 渲染缩略图，并控制分辨率
tm_export_video	为离线渲染流程生成 OBJ 衍生文件
tm_list_scenes	从元数据视图和对象树中枚举场景

---

端点（scanbim-mcp）

路径	方法	描述
/mcp	POST	MCP JSON-RPC 2.0 端点（initialize、tools/list、tools/call、ping）
/info	GET	服务信息、版本、工具数量、APS 连接状态
/health	GET	健康检查，并显示 APS 配置状态
/token	GET	用于 Viewer JS 集成的 APS 访问令牌（viewables:read 作用域）
/viewer?urn=XXX	GET	内置 APS Viewer JS v7，可在浏览器中加载任意已转换模型

---

快速开始

使用托管的 MCP（推荐）

添加到 Claude Desktop 配置中：

{

  "mcpServers": {

    "scanbim": {

      "url": "https://scanbim-mcp.itmartin24.workers.dev/mcp"

    },

    "revit": {

      "url": "https://revit-mcp.itmartin24.workers.dev/mcp"

    },

    "acc": {

      "url": "https://acc-mcp.itmartin24.workers.dev/mcp"

    },

    "navisworks": {

      "url": "https://navisworks-mcp.itmartin24.workers.dev/mcp"

    },

    "twinmotion": {

      "url": "https://twinmotion-mcp.itmartin24.workers.dev/mcp"

    }

  }

}

curl

# Health check

curl https://scanbim-mcp.itmartin24.workers.dev/health



# List tools

curl -X POST https://scanbim-mcp.itmartin24.workers.dev/mcp \

  -H "Content-Type: application/json" \

  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'



# View a model

open "https://scanbim-mcp.itmartin24.workers.dev/viewer?urn=YOUR_BASE64_URN"

部署自己的实例

git clone https://github.com/ScanBIM-Labs/scanbim-mcp.git

cd scanbim-mcp

npm install

npx wrangler secret put APS_CLIENT_ID

npx wrangler secret put APS_CLIENT_SECRET

npx wrangler deploy

---

架构

Claude / ChatGPT / Any AI Agent

    | MCP Protocol (JSON-RPC 2.0)

    v

Cloudflare Workers (5 workers, edge compute, <50ms global)

    |-- scanbim-mcp (19 tools + /viewer + /token)

    |-- revit-mcp (8 tools)

    |-- acc-mcp (9 tools)

    |-- navisworks-mcp (5 tools)

    |-- twinmotion-mcp (5 tools)

    |

    |-- D1 Database (VDC rules, clash severity, coordination standards)

    |-- KV Namespace (APS token caching with TTL)

    |

    v

Autodesk Platform Services (APS)

    |-- Authentication v2 (2-legged client credentials)

    |-- Model Derivative v2 (SVF2 translation, metadata, properties)

    |-- Object Storage Service (file upload, bucket management)

    |-- ACC Issues/RFIs API

    |-- APS Viewer JS v7 (browser-based 3D rendering)

    |

    v

scanbim.app (Cloudflare Pages) + APS Viewer (/viewer route)

---

支持的格式（50 多种）

免费： IFC、glTF/GLB、OBJ、STL、PLY、E57、LAS/LAZ、DXF、DAE、3DS、3MF

专业版（$49/月）： + FBX、DWG、STEP/STP、IGES、SketchUp（.skp）、DWF、SolidWorks（.sldprt/.sldasm）、Inventor（.ipt/.iam）、OSGB

企业版（$149/月）： + Revit（.rvt/.rfa）、Navisworks（.nwd/.nwc）、ReCap（.rcp/.rcs）、PCD、PTS、FLS、PTX、PTG、ZFS、3MX + 500M 点云 + ACC 集成

---

VDC 智能引擎

碰撞检测由编码了20 年现场经验的 D1 支持规则驱动：

• 9 条严重性规则 — SMACNA、NEC、ACI 318、AISC、ASCE 7 标准

• 5 项协调标准 — MEP 净空、结构邻近度

• 修复建议 — 提供真实的施工建议，而非泛泛地说“移动构件”

• 返工估算 — 根据实际项目数据估算修复所需工时

---

链接

• APS Viewer： https://scanbim-mcp.itmartin24.workers.dev/viewer

• 健康检查： https://scanbim-mcp.itmartin24.workers.dev/health

• 产品网站： https://scanbim.app

• 公司： https://scanbimlabs.io

• MCP 工具页面： https://scanbimlabs.io/mcp

---

许可证

MIT — 可免费用于商业用途。

---

ScanBIM Labs — VDC + AI + Reality Capture

20 年 BIM/VDC 运营经验，如今全面采用 AI 原生技术。由 VDC 从业者打造，而非软件开发公司。

身份验证

支持两种请求头格式。只能使用其中一种，切勿混用：

1. x-scanbim-api-key: <your_user_key> — 值为原样的 user_key。
2. Authorization: Bearer sk_scanbim_<your_user_key> — 值为包含 sk_scanbim_ 前缀的完整字符串；D1 的 user_key 列必须与此完整字符串匹配。

混用格式会自动为备用密钥创建一个新的免费套餐记录（每次切换时，都会静默地获得一个新的 50 积分账户）。

请前往 scanbim.app/settings/billing 获取你的 user_key。

示例

curl -X POST https://mcp.scanbimlabs.io/unified/mcp \
  -H "content-type: application/json" \
  -H "x-scanbim-api-key: $SCANBIM_USER_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_models","arguments":{}}}'

响应代码

• 200 — 工具调用已继续；积分已扣除。
• 401 — 缺少身份验证请求头或格式错误（中间件会返回 JSON-RPC 错误代码 -32001）。
• 402 — 积分不足；响应正文包含全部 5 种积分包的 checkout_urls 和账单页面的 top_up_url。