Twinmotion

io.scanbimlabs由 scanbimlabs.io 发布官方发布者v1.1.0更新于 Oct 24, 2026

Twinmotion rendering + video export via Datasmith pipeline.

发布方自己的服务:Acc

已验证Streamable HTTP可网页运行开发者工具媒体与设计

概览

AI 生成的概览

远程 MCP 服务器,让助手驱动 Twinmotion 渲染流程:导入 Revit 模型、设置环境、渲染图像并导出漫游视频。

可以做什么
通过 Datasmith 流程将 Revit 模型导入 Twinmotion,并列出项目中已保存的场景和动画。设置场景的天气、时段和环境条件。渲染最高 8K 的静态图像,并导出 MP4、MOV 或 WebM 格式的漫游视频。
适用场景
适用于建筑、工程和施工场景:希望助手无需在桌面软件中手动操作,即可准备 Twinmotion 场景、生成渲染静帧或根据 Revit 模型制作漫游视频。
运行要求
通过 streamable HTTP 访问的远程端点,需在 Authorization 请求头中提供 bearer 令牌,即从服务商计费设置获取的 ScanBIM API 密钥。服务运行在 Cloudflare Workers 上,服务端使用 APS OAuth2 客户端凭据。每次工具调用会消耗积分。
安装前请注意
Authorization 请求头携带密钥;README 警告混用两种可接受的请求头格式会静默创建独立的免费套餐账户,每次切换获得 50 积分。工具调用会扣除积分,返回 402 表示积分不足并附带充值链接。渲染和视频导出是耗时且占用资源较多的操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Twinmotion,将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.scanbimlabs%2Ftwinmotion/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "twinmotion": {
      "type": "http",
      "url": "https://mcp.scanbimlabs.io/twinmotion",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Twinmotion MCP

Twinmotion rendering pipeline via APS — Import Revit models, set environments, render images, export walkthrough videos.

[Live] [MCP]

Tools (5)

ToolDescription
tm_import_rvtImport Revit model into Twinmotion
tm_set_environmentSet weather, time-of-day, environment
tm_render_imageRender still image (up to 8K)
tm_export_videoExport walkthrough video (MP4/MOV/WebM)
tm_list_scenesList saved scenes and animations

Quick Start

json
{
  "mcpServers": {
    "twinmotion": {
      "url": "https://twinmotion-mcp.itmartin24.workers.dev/mcp"
    }
  }
}

Architecture

  • Runtime: Cloudflare Workers
  • Auth: APS OAuth2 (client_credentials)
  • Cache: Cloudflare KV (token caching)

Part of ScanBIM Labs AEC MCP Ecosystem

MIT — ScanBIM Labs LLC

Authentication

Two accepted header formats. Use one, do NOT mix:

  1. x-scanbim-api-key: <your_user_key> — value is the user_key verbatim.
  2. Authorization: Bearer sk_scanbim_<your_user_key> — value is the entire string including the sk_scanbim_ prefix; the D1 user_key column must match this full string.

Mixing formats auto-creates a fresh free-plan row for the alternate key (you'll silently get a new 50-credit account on each switch).

Get your user_key at scanbim.app/settings/billing.

Example

bash
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":{}}}'

Response codes

  • 200 — tool call proceeded; credits debited.
  • 401 — missing or malformed auth header (middleware returns JSON-RPC error code -32001).
  • 402 — insufficient credits; response body includes checkout_urls for all 5 credit packs and top_up_url for the billing page.

来源:README.md,提交 625761d

工具

0
该服务器需要 API 密钥等凭据,因此 SourceWeft 无法在没有凭据的情况下读取其工具,也未收录。

版本历史

1
  1. v1.1.0最新Sep 16, 2026

评分

已满足适用检查项的 75%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list,或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。

其他 Scanbimlabs 集成