scanbim-mcp

Name: scanbim-mcp
Author: scanbim.app

本地服务

github.com/ScanBIM-Labs媒体与设计627 周前更新

代码仓库

关于 scanbim-mcp

scanbim-mcp 是面向建筑、工程与施工团队的 BIM MCP 工具集，连接 Revit、Navisworks、ACC 和可视化工作流。它提供模型处理、碰撞分析、项目协作及 XR 查看工具，并通过 Autodesk Platform Services 执行 API 调用。

主要功能

01上传与转换多种 BIM 格式
02Revit 元素、参数和明细表提取
03碰撞检测与协调报告
04ACC 问题、RFI 和文档管理
05生成渲染与 XR 查看会话

适用场景

01检查 BIM 模型中的碰撞
02从 Revit 提取元素和明细表数据
03在 ACC 中创建问题或 RFI
04生成模型查看链接或 XR 会话

MCP 相关

通过 `/mcp` 提供 MCP JSON-RPC 端点，向客户端开放模型、Revit、ACC、Navisworks、渲染和 XR 等工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "app-scanbim-scanbim": {
      "command": "npx",
      "args": [
        "-y",
        "@scanbim-labs/scanbim-mcp"
      ]
    }
  }
}

启动命令npx -y @scanbim-labs/scanbim-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@scanbim-labs/scanbim-mcp1.0.6Streamable HTTP

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

ScanBIM MCP — 面向 AEC 的 AI 中枢

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

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

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

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

| 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 从业者打造，而非软件开发公司。

身份验证

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

x-scanbim-api-key: <your_user_key> — 值为原样的 user_key。
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。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。