Unity MCP 安裝指南與使用

簡介

什麼是 Unity MCP？

MCP for Unity 是由 Coplay 開發並維護的開源專案，透過 Model Context Protocol（MCP） 將 AI 助手（Claude、Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI 等）與你的 Unity Editor 串接起來。

簡單來說，只要你開著 Unity 編輯器，就可以直接對 AI 說：「幫我建立一個有紅色、藍色和黃色方塊的場景」或「幫我寫一個簡單的玩家控制器」，AI 就能透過 MCP 協定直接操作你的 Unity 專案。

核心特性

• 自然語言控制：用文字描述任務，讓 AI 直接在 Unity 中執行
• 豐富工具集：管理資產、場景、材質、腳本、UI、動畫、著色器等
• 高效能批次執行：batch_execute 指令比逐一呼叫快 10 ～ 100 倍
• 可擴充自訂工具：支援 Roslyn 執行時期腳本驗證與自訂工具擴充
• 多 Unity 實例支援：可同時連接多個 Unity Editor 並指定目標實例
• MIT 授權：完全開源免費

支援的 MCP 客戶端

• Claude Desktop
• Claude Code
• Cursor
• VS Code Copilot
• GitHub Copilot CLI
• Windsurf

WSL2 安裝與初始化指南

什麼是 WSL2？

WSL2（Windows Subsystem for Linux 2）是 Windows 內建的 Linux 執行環境，讓你不用雙系統或傳統虛擬機，也能在 Windows 上直接使用 Ubuntu 等 Linux 發行版。

相較於 WSL1，WSL2 的主要優勢：

• 使用真實 Linux Kernel，相容性更好
• 與 Docker、Kubernetes 等工具整合更完整
• 支援 systemd（需在發行版內啟用）
• 更適合 Node.js、Python、容器化開發場景

GitHub Copilot CLI 安裝指南

GitHub Copilot CLI 是 GitHub Copilot 的命令列介面工具，讓開發者可以直接在終端機中與 Copilot 互動。它能夠理解你的程式碼庫，協助撰寫程式碼、修復錯誤、建立新功能，甚至執行多步驟的自動化任務。

前置需求

• 有效的 GitHub Copilot 訂閱方案（所有 Copilot 方案皆支援）
• Windows 環境需使用 PowerShell v6 以上版本
• 若透過組織或企業取得 Copilot 授權，需確認管理員已啟用 Copilot CLI 功能

VSCode 與 Java 環境整合

在 VSCode 中進行 Java 開發，需要完成 JDK 安裝、環境變數配置 以及 擴充套件安裝 三個核心步驟。本文將系統性地介紹從環境建置到專案運行的完整流程，幫助開發者在 VSCode 上高效進行 Java 開發。

VSCode 安裝指南

什麼是 VSCode？

Visual Studio Code（簡稱 VSCode）是由 Microsoft 開發的免費、開源程式碼編輯器，支援 Windows、macOS 和 Linux 三大平台。它具備以下特點：

• 輕量且快速 — 啟動速度快，佔用系統資源少，適合日常開發使用
• 豐富的擴充套件生態系 — 透過 Extensions Marketplace 安裝各種語言支援、主題、工具整合
• 內建終端機 — 可直接在編輯器中操作命令列，無需切換視窗
• Git 整合 — 內建版本控制功能，支援 diff、commit、branch 等操作
• IntelliSense 智慧提示 — 提供自動補全、參數提示、快速文件查閱等功能
• 跨平台一致體驗 — 在不同作業系統下擁有相同的操作介面與功能

Yarn 使用指南

什麼是 Yarn？

Yarn 是一個快速、可靠且安全的 JavaScript 套件管理工具，由 Facebook、Google、Exponent 和 Tilde 共同開發，用於管理 Node.js 專案中的依賴套件。

主要特點

• 快速：並行化操作，提升安裝速度
• 可靠：使用詳細的鎖定檔案（lockfile）確保跨裝置的一致性
• 安全：使用校驗和驗證每個已安裝套件的完整性
• 離線模式：已快取的套件可在離線狀態下重新安裝
• 工作區（Workspaces）：原生支援 monorepo 專案管理

Docker Compose 編寫指南

什麼是 Docker Compose？

Docker Compose 是一個用於定義和管理多容器 Docker 應用程式的工具。透過 YAML 檔案來配置應用程式的服務、網路和資料卷，讓您可以用單一命令來建立和啟動所有相關的服務。

Docker Compose 的優勢

• 簡化多容器管理：用一個檔案定義整個應用程式架構
• 環境一致性：確保開發、測試、生產環境的一致性
• 快速部署：一鍵啟動整個應用程式堆疊
• 服務編排：輕鬆管理服務間的依賴關係
• 可重現性：版本控制友好，便於團隊協作

使用場景

• 微服務架構：管理多個相互依賴的服務
• 開發環境：快速搭建完整的開發環境
• 測試環境：創建隔離的測試環境
• CI/CD 流程：自動化部署和測試

Docker Dockerfile 編寫指南

什麼是 Dockerfile？

Dockerfile 是一個文字檔案，包含了一系列指令用來自動化建構 Docker 映像檔。透過 Dockerfile，我們可以將應用程式及其運行環境封裝成一個可移植的映像檔，實現「一次建構，到處運行」的目標。

Dockerfile 的優勢

• 可重現性：確保在不同環境中建構出相同的映像檔
• 版本控制：可以像程式碼一樣進行版本管理
• 自動化：減少手動配置，降低人為錯誤
• 標準化：統一的建構流程和環境配置

Docker 基本介紹

架構總覽

上圖展示了 Docker 完整架構，包含 Docker 客戶端、Docker 守護程序、容器運行時、映像檔倉庫等核心元件及其互動關係

Docker 如何運作？

Docker 采用客戶端-伺服器架構，主要包含以下工作流程：

1. 開發階段：使用 Dockerfile 定義應用程式環境
2. 建構階段：透過 docker build 將 Dockerfile 轉換為映像檔
3. 分享階段：將映像檔推送到 Docker Registry 進行分享
4. 部署階段：在任何支援 Docker 的環境中運行容器

這個流程確保了「一次建構，到處運行」的目標。

Kubernetes Secret 使用指南

什麼是 Secrets？

Kubernetes Secrets 是一個 API 物件，用於存儲和管理敏感資訊，如密碼、OAuth 權杖、SSH 金鑰等。Secrets 類似於 ConfigMap，但專門設計用於保存機密資料，提供了額外的安全性保護。

Secrets 的主要功能：

• 敏感資料存儲：安全地存儲密碼、金鑰、憑證等敏感資訊
• 資料加密：在 etcd 中以 Base64 編碼存儲（可配置加密）
• 存取控制：透過 RBAC 控制對敏感資料的存取
• 多種類型支援：支援不同類型的機密資料格式

為什麼使用 Secrets？

相較於將敏感資料硬編碼在應用程式或 ConfigMap 中，Secrets 提供了更安全的管理方式：

1. 安全性：敏感資料與應用程式程式碼分離
2. 存取控制：精細的權限管理和審計功能
3. 靈活性：支援多種掛載和使用方式
4. 合規性：符合企業安全和合規要求