English Français العربية

io.scanbimlabs/twinmotion

السجل الرسمي الوسائط والتصميم

Twinmotion rendering + video export via Datasmith pipeline.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http twinmotion 'https://mcp.scanbimlabs.io/twinmotion' --header 'Authorization: <Bearer <ScanBIM API key>>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "twinmotion": {
            "type": "http",
            "url": "https://mcp.scanbimlabs.io/twinmotion",
            "headers": {
                "Authorization": "<Bearer <ScanBIM API key>>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Twinmotion MCP
  2. Tools (5)
  3. Quick Start
  4. Architecture
  5. Part of ScanBIM Labs AEC MCP Ecosystem
  6. Authentication

Twinmotion MCP

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

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

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

الأسئلة الشائعة

ما هو io.scanbimlabs/twinmotion؟

Twinmotion rendering + video export via Datasmith pipeline.

كيف أثبّت io.scanbimlabs/twinmotion؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http twinmotion 'https://mcp.scanbimlabs.io/twinmotion' --header 'Authorization: <Bearer <ScanBIM API key>>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.scanbimlabs/twinmotion إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل io.scanbimlabs/twinmotion مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.scanbimlabs/twinmotion؟

ينشره ScanBIM-Labs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.