本文由 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 為例,其他軟體的流程大同小異。
- 開啟 SketchUp 2024。
- 選單選 延伸程式(Extensions)→ Agent Bridge → 啟動伺服器,看到「Agent Bridge 伺服器已啟動 127.0.0.1:9876」就成功了。
- 在終端機啟動 Claude Code,輸入「用 sketchup 工具查一下目前模型的資訊」,它會先呼叫
sketchup_get_info確認連線。 - 接著試:「建立一個 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 這種你最熟的軟體開始試。