SHAO-EN

agent-bridges 使用教學:讓 AI 直接操作 SketchUp、Rhino、Blender 與 Power Automate

Claude
Claude AI 助理 / Anthropic
閱讀時間約 11 分鐘

如果你不知道該如何操作,請把這篇文章交給你的 Claude 或 ChatGPT。

原始碼、下載與更新紀錄都在 GitHub:

在 GitHub 查看原始碼

本文由 Claude(Anthropic 的 AI 助理)根據站長提供的專案說明與設計筆記整理撰寫。站長是建築系畢業、非工程師出身的創業者,這套工具是他為了讓 AI 直接動手操作建築常用軟體而做的;專案已在 GitHub 以 MIT 授權開源,本文教你怎麼安裝與使用。

這是什麼?能幫你做什麼?

agent-bridges 是一組「橋接器」:在你自己的電腦上,替 AI agent(例如 Claude Code,或任何支援 MCP 的客戶端)接上桌面軟體。接上之後,AI 不只是「告訴你該按哪裡」,而是能自己看畫面、下指令、建模,再截圖檢查結果。

目前有四個橋接器:

  • SketchUp 2024:用 Ruby API 建模與改幾何、切換工具、視埠截圖。
  • Rhino 7 + Grasshopper:用 IronPython(RhinoCommon)建模、下 Rhino 指令,也能在 Grasshopper 放元件、連線、求解、烘焙。
  • Blender 3.4:用 bpy 建立與修改物件、切換視角、算圖。
  • Power Automate Desktop(PAD):執行桌面流程、讀寫流程的 Robin 腳本。

名詞白話解釋:MCP(Model Context Protocol)是讓 AI 呼叫外部工具的共通介面,你可以把它想成「AI 的插座標準」;橋接器就是接在插座和軟體之間的轉接頭。

裝好之後,你可以直接用中文對 AI 說:

  • 「在 SketchUp 畫一個 3000 × 2000 × 2800 公釐的量體,命名為『量體』,切到等角視圖截圖給我看。」
  • 「在 Rhino 裡把選取的曲線擠出 3 公尺,再把結果放到新圖層。」
  • 「執行我的 Power Automate 流程,帶入文字參數,跑完告訴我輸出變數。」

AI 會先查詢目前的場景,再操作,最後用截圖確認;每個會改模型的操作也都包在 undo(復原)記錄裡,你按一次 Ctrl+Z 就能退一步。

運作原理

四個橋接器的結構相同,差別只在「軟體裡面那一段」:

 AI agent(Claude Code 等 MCP 客戶端)
        │  stdio(MCP)
        ▼
 ┌─────────────────────────────────────────┐
 │ Python 套件(MCP 伺服器+命令列工具)   │
 └──────────────────┬──────────────────────┘
                    │ TCP、一行一筆 JSON,只限 127.0.0.1
                    ▼
 ┌─────────────────────────────────────────┐
 │ 軟體內部的小伺服器(外掛或腳本)        │
 │ 請求先排隊,再於軟體的主執行緒執行      │
 └─────────────────────────────────────────┘

AI 發出的每個動作,會先變成一行 JSON 訊息,從電腦內部的網路埠送進軟體;軟體裡的小伺服器收到後,排隊交給軟體自己的主執行緒執行,再把結果送回來。這樣做的好處是軟體不會因為被「同時」操作而當掉。

例外是 Power Automate Desktop:它沒有可用的腳本 socket,所以 pad-bridge 改用 Windows 的 UI Automation 操作 PAD,並讀取 PAD 的本機執行紀錄。

預設的本機連接埠如下:

  • SketchUp:127.0.0.1:9876
  • Blender:127.0.0.1:9877
  • Rhino:127.0.0.1:9878
  • Power Automate:不使用連接埠

每個橋接器另外附一份 Claude skill(放在 skill/ 資料夾,安裝時會複製到 Claude Code 的 skills 資料夾)。它是寫給 AI 看的「工作守則」,例如先查場景、操作、截圖驗證的循環,以及各軟體的寫法注意事項。

需求

  • Windows 10 或 11
  • Python 3.10 以上(系統上要裝好;安裝程式會自己找,並為每個橋接器建立獨立的虛擬環境)
  • 你要用的軟體,版本對應如下:SketchUp 2024、Rhino 7(含 Grasshopper)、Blender 3.4、Power Automate Desktop
  • 一個支援 MCP 的 AI 客戶端;本文以 Claude Code 為例,因為安裝程式會自動替它註冊

你不需要四個都裝,只裝自己會用的那幾個即可。

安裝步驟

1. 下載專案

用 git 下載(專案公開後可用):

git clone https://github.com/shaoen901109/agent-bridges.git
cd agent-bridges

沒有裝 git 的話,也可以在 GitHub 頁面按 Code,選 Download ZIP,解壓縮後進入資料夾。

2. 執行各橋接器的安裝程式

進入你要用的橋接器資料夾,執行它的安裝程式。Rhino、SketchUp、Power Automate 是 PowerShell 腳本:

cd rhino            # 或 sketchup、power-automate
powershell -ExecutionPolicy Bypass -File .\install.ps1

Blender 是 Python 腳本:

cd blender
python install.py

如果從 PyPI 下載套件很慢,PowerShell 版可以加 -PipIndex 指定鏡像網址,例如:

powershell -ExecutionPolicy Bypass -File .\install.ps1 -PipIndex https://你的鏡像網址/simple

安裝程式可以重複執行,各自做的事情如下:

  • SketchUp:把 Ruby 擴充功能複製到 SketchUp 的 Plugins 資料夾(只動自己的檔案)。
  • Rhino:編譯並登錄 .rhp 外掛,讓它隨 Rhino 啟動載入。
  • Blender:把 startup 腳本複製到 Blender 3.4 的 scripts\startup\ 資料夾。
  • Power Automate:不需要裝進軟體,只建好 Python 環境。

四個都會在使用者資料夾下建立獨立的 venv(Python 虛擬環境,可以理解成「這個工具專用的 Python 小房間」),裝好所需套件,把 skill 複製到 ~\.claude\skills\,並把 MCP 註冊到 Claude Code。

注意:Rhino 開著的時候,外掛檔會被鎖住無法覆蓋;要更新外掛本體,請先關閉 Rhino 再重跑 install.ps1。

3. 重啟軟體與 Claude Code

安裝後,請重啟對應的軟體,並新開一個 Claude Code 對話,才看得到新的 MCP 工具。

在 Claude Code 註冊 MCP

安裝程式已經替 Claude Code 自動註冊,通常這一步可以跳過。如果你想手動註冊,或安裝時加了 -SkipClaudeCodeMcp,指令如下(以 SketchUp 為例):

claude mcp add sketchup --scope user -- "$env:USERPROFILE\SketchUpAgentBridge\venv\Scripts\python.exe" -m sketchup_bridge.mcp_server
claude mcp get sketchup

最後一行應顯示 Connected。其他三個橋接器的寫法一樣,只需替換名稱與路徑:

  • Rhino:名稱 rhino,資料夾 RhinoAgentBridge,模組 rhino_bridge.mcp_server
  • Blender:名稱 blender,資料夾 BlenderAgentBridge,模組 blender_bridge.mcp_server
  • Power Automate:名稱 pad,資料夾 PADAgentBridge,模組 pad_bridge.mcp_server

參數順序很重要:伺服器名稱要放在 --scope 之前,否則 Claude Code 會把後面的 -m 當成自己的選項,出現 unknown option '-m' 的錯誤。

如果你用的是別的 MCP 客戶端(例如 Claude Desktop),請在它的設定檔 mcpServers 裡加入這樣一筆(把 <USER> 換成你的 Windows 使用者名稱):

{
  "mcpServers": {
    "sketchup": {
      "command": "C:\\Users\\<USER>\\SketchUpAgentBridge\\venv\\Scripts\\python.exe",
      "args": ["-m", "sketchup_bridge.mcp_server"],
      "env": {
        "SKETCHUP_BRIDGE_PORT": "9876",
        "SKETCHUP_BRIDGE_MAX_EDGE": "1280"
      }
    }
  }
}

請用「合併」的方式加進既有設定,不要整份覆蓋。各橋接器的 mcp-examples 資料夾都有現成範例。

第一次試用

以 SketchUp 為例,其他軟體的流程大同小異。

  1. 開啟 SketchUp 2024。
  2. 選單選 延伸程式(Extensions)→ Agent Bridge → 啟動伺服器,看到「Agent Bridge 伺服器已啟動 127.0.0.1:9876」就成功了。
  3. 在終端機啟動 Claude Code,輸入「用 sketchup 工具查一下目前模型的資訊」,它會先呼叫 sketchup_get_info 確認連線。
  4. 接著試:「建立一個 3000 × 2000 × 2800 公釐的方塊,切到等角視圖並截圖。」

各軟體第一次要注意的地方:

  • Rhino:外掛會隨 Rhino 啟動自動開伺服器,不用手動開。如果 AI 回報 RHINO_NOT_AVAILABLE,代表 Rhino 沒開、外掛沒裝,或伺服器被停了(可在 Rhino 指令列輸入 RhinoBridgeStart)。
  • Blender:重啟後,System Console 會印出 listening on 127.0.0.1:9877。不想重啟的話,可以在 Text Editor 開啟 blender_bridge.py 按 Run Script,效果相同,只到這次 Blender 關閉為止。
  • Power Automate:PAD 預設每次被外部觸發都會跳出確認框。可在 PAD 設定關閉,或安裝時加 -AutoConfirm,讓 bridge 只替自己剛觸發、名稱相符的流程按「繼續」。另外,建立或修改流程時會用真實的鍵盤滑鼠操作設計工具,約 20 到 60 秒,期間請不要動電腦;同時也只能跑一個流程。

安全設計

AI 能操作你的軟體,等於把一部分控制權交出去,所以專案的安全設計是刻意保守的:

  • 只綁 127.0.0.1:伺服器只接受本機連線,區網與網際網路都連不進來。
  • 沒有驗證機制:任何能在你電腦上執行程式的人都能連上,所以不要把監聽位址改成對外,也不要做 port forwarding(路由器的埠轉發)。
  • SketchUp 預設關閉:伺服器必須由你從選單手動啟動,AI 沒辦法自己打開。建議用的時候才開,用完就停止。
  • 覆蓋與開檔需要明確同意:存檔覆蓋要 overwrite、開新檔或開檔要 confirm 旗標,AI 不能默默蓋掉你的檔案。
  • 沒有關閉軟體的工具:任何橋接器都沒有「關閉」或「強制結束」軟體的指令。
  • 可復原:軟體支援時,模型修改都包在 undo 記錄裡。
  • 任意程式碼是雙面刃:sketchup_eval_ruby、rhino_eval_python、gh_eval_python 這類工具能執行任意程式,等於把軟體,以及該語言環境能碰到的使用者權限,交給 AI。請只對你信任的 AI 啟用。

常見問題

連不上,提示無法連線?先確認軟體有開。SketchUp 要記得從選單啟動伺服器;Rhino 可試試 RhinoBridgeStart;Blender 要確認重啟過。

選單裡沒有「Agent Bridge」?重跑 install.ps1 後重新啟動 SketchUp,並檢查擴充功能管理員有沒有被停用。

連接埠被佔用?可在各軟體的設定改用其他埠,並同步設定環境變數(例如 SKETCHUP_BRIDGE_PORT、BLENDER_BRIDGE_PORT、RHINO_BRIDGE_PORT),讓軟體端與 AI 端一致。

指令一直逾時?軟體可能被對話框卡住了,請看一眼畫面;也可以調長環境變數裡的逾時秒數。

Claude Code 裡看不到 MCP 工具?用 claude mcp get <名稱> 檢查是否 Connected,並確認是在安裝後新開的對話。

Rhino 的 Python 為什麼是舊語法? Rhino 7 內建的是 IronPython 2.7,所以 rhino_eval_python 要用 Python 2.7 的語法;橋接器本身用的 Python 3.10+ 是另一個行程,兩邊只透過 JSON 溝通。

下載與校驗(確認檔案沒被動過)

建議到 GitHub 的 Releases 頁面下載正式版本的 agent-bridges-v1.0.0.zip,同一頁還有 SHA256SUMS.txt。SHA256 是檔案的數位指紋:檔案只要被改過一個位元組,指紋就完全不同。

下載後在 PowerShell 執行下面這行,把輸出的 Hash 跟 SHA256SUMS.txt 裡的字串比對,一樣就代表檔案完整(大小寫不同沒關係):

Get-FileHash .\agent-bridges-v1.0.0.zip -Algorithm SHA256

想再進一步,可以安裝 GitHub CLI 後執行下面這行。它會檢查 GitHub 的「來源證明」(attestation),顯示驗證成功,代表這個 zip 是 GitHub 雲端從這個 repo 的原始碼自動建出來的,不是別人另外上傳的:

gh attestation verify .\agent-bridges-v1.0.0.zip --repo shaoen901109/agent-bridges

另外,GitHub 上標示綠色 Verified 的 commit,代表是作者本人簽章送出的修改。發現安全性問題請寄信到 [email protected],不要開公開的 issue。

連結與授權

  • GitHub:agent-bridges(安裝方式見 README;Blender 版的跳過參數是 --skip-mcp)
  • 授權:MIT,可自由使用、修改與散布

更完整的工具清單、命令列用法與疑難排解,請看各橋接器資料夾裡的 README。如果你也想讓 AI 幫忙跑建築日常的重複工作,不妨從 SketchUp 或 Blender 這種你最熟的軟體開始試。

文章標籤 (Keywords) #agent-bridges #MCP #SketchUp #Rhino #Blender