🔌 MCP + Unity 對接教學
讓你的 Unity Editor 被 AgEnD（Discord AI 助手）操控
你的 Discord 頻道（AgEnD instance）
↕ 網路
遠端伺服器（AgEnD daemon + MCP client）
↕ WebSocket (port 8090)
你的電腦（Unity Editor + MCP Unity Plugin）
0 前置條件
- Windows 電腦
- Unity 6 或更新版本（可建立空專案）
- 網路連線
1 安裝 Node.js
MCP Unity Server 需要 Node.js 18 以上。
- 前往 https://nodejs.org
- 下載 LTS 版本 的 Windows Installer (.msi)
- 執行安裝，全部選預設即可
- 驗證安裝：打開 PowerShell，輸入：
node --version
看到 v18.x.x 或更高就OK ✓
2 建立 Unity 空專案
- 打開 Unity Hub
- 點「New Project」
- 選擇任意模板（建議 2D 或 3D Core）
- 取個名字，建立專案
- 等待專案開啟完成
3 安裝 MCP Unity 套件
- 在 Unity 中，打開 Window → Package Manager
- 點左上角的 「+」按鈕
- 選擇 「Add package from git URL...」
- 貼入以下網址：
https://github.com/CoderGamester/mcp-unity.git
- 點 Add，等待安裝完成
4 啟動 MCP Server
- 在 Unity 中，打開 Tools → MCP Unity → Server Window
- 如果顯示需要 Build Server，點 「Force Install Server」 按鈕
- 等待 Server 安裝完成（需要幾秒鐘）
- 點 「Start Server」
- 看到綠色狀態表示 WebSocket Server 已啟動（預設 port 8090）
5 設定遠端連線
因為 AgEnD instance 在遠端伺服器，Unity 在你的本機，需要讓遠端能連到你。
方案 A：允許遠端連線（推薦）
- 在 Unity 的 MCP Server Window 中
- 勾選 「Allow Remote Connections」
- 重新點 Start Server
- 記下你電腦的內網 IP：
ipconfig
找到 IPv4 位址，例如 10.1.x.x 或 192.168.x.x
⚠️ 防火牆設定：如果連不上，需要允許 port 8090 入站：
Windows Defender Firewall → 進階設定 → 新增輸入規則 → Port → TCP 8090 → 允許
方案 B：使用 ngrok 穿透（如果方案A不通）
- 下載 ngrok：https://ngrok.com/download
- 註冊免費帳號取得 authtoken
- PowerShell 執行：
ngrok tcp 8090
記下產生的公開位址（例如 tcp://0.tcp.ngrok.io:12345）
6 告訴 AgEnD instance 連線資訊
到你的 Discord 頻道（你的 AgEnD instance），告訴他：
我的 Unity MCP Server 已啟動，IP 是 [你的IP]，port 是 8090
他就會嘗試連線。連線成功後，你在 Unity 的 Server Window 會看到綠色的連線狀態。
7 測試
連線成功後，跟你的 AgEnD instance 說：
幫我在場景中建一個空的 GameObject，命名為 "TestUI"
✅ 如果 Unity 的 Hierarchy 中出現了「TestUI」，恭喜對接成功！🎉
❓ 常見問題
- Q: Start Server 按了沒反應？
- 確認 Node.js 已安裝。在 Server Window 點「Force Install Server」重新安裝。
- Q: 遠端連不上？
- 確認防火牆允許 port 8090 的入站連線。確認 Allow Remote Connections 有勾選。
- Q: AgEnD 說連線失敗？
- 確認 Unity 的 Server Window 顯示 Server 正在運行（綠色狀態）。確認 IP 正確。
- Q: 安裝套件時報錯？
- 確認 Unity 版本是 6 或更新。舊版 Unity 不支援此套件。
🚀 接下來可以做什麼？
連線成功後，你可以用自然語言請 AI 幫你：
- 建立 UI Canvas、Panel、Button、Image 等
- 修改 GameObject 的位置、大小、顏色
- 匯入圖片素材到場景中
- 讀取場景結構
- 建立 Material 和指定 Shader
- 還有更多...