Twinmotion

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

Twinmotion rendering + video export via Datasmith pipeline.

發布方自己的服務：Acc

已驗證Streamable HTTP可網頁執行開發者工具媒體與設計

服務詳細資訊

識別碼: io.scanbimlabs/twinmotion
傳輸: Streamable HTTP
執行環境: Web executable
信任: Verified
發布於: Sep 16, 2026

安全提示

MCP 服務會接收對話中的工具呼叫請求，並可能執行外部操作。啟用前請先了解該服務能做什麼，並只授予它所需的權限。

註冊中心已驗證此服務的命名空間屬於 scanbimlabs.io，且該網域同時執行其端點。這可以確認發布者，但並不代表該服務的工具是安全的。

SourceWeft 的檢查只涵蓋條目是否完整、端點是否回應；不審查伺服器的程式碼，也不審查其工具的行為。

在 README 中新增徽章

向讀者展示該 MCP 服務已收錄於 SourceWeft，徽章連結到本頁。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.scanbimlabs%2Ftwinmotion.svg)](https://sourceweft.com/mcp/io.scanbimlabs%2Ftwinmotion?utm_source=readme&utm_medium=badge)

概覽

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 中

開啟儀表板中的 Twinmotion，將其新增到工作區。
連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
為需要使用其工具的對話啟用該服務。

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)

Tool	Description
`tm_import_rvt`	Import Revit model into Twinmotion
`tm_set_environment`	Set weather, time-of-day, environment
`tm_render_image`	Render still image (up to 8K)
`tm_export_video`	Export walkthrough video (MP4/MOV/WebM)
`tm_list_scenes`	List saved scenes and animations

Quick Start

json

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

{
  "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:

x-scanbim-api-key: <your_user_key> — value is the user_key verbatim.
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":{}}}'

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