## feat(editor): Enhance MCP Unity Editor UI and documentation. These changes aim to make the MCP Unity Editor more user-friendly, easier to configure, and better documented for developers.

Key changes include:
- **Editor UI Enhancements:** Updated `McpUnityEditorWindow.cs` to include new sections for connected clients, npm executable path configuration, and direct buttons for configuring Windsurf, Claude Desktop, and Cursor IDEs.
- **New Settings:** Added `NpmExecutablePath` to `McpUnitySettings.cs` to allow users to specify a custom npm executable path.
- **Utility Functions:** Implemented new utility methods in `McpUtils.cs` for generating MCP configuration JSON, integrating with various IDEs, and running npm commands for server installation/building.
- **Comprehensive Documentation:** Overhauled `README.md` and its localized versions (`README-ja.md`, `README_zh-CN.md`) with detailed features, installation steps, usage guides, debugging information, and an extensive FAQ section.
- **Documentation Assets:** Added a new `docs/` directory containing images referenced in the updated README files.

Author: CoderGamester

Editor/UnityBridge/McpUnityEditorWindow.cs

@@ -22,6 +22,7 @@ public class McpUnityEditorWindow : EditorWindow
         private string _mcpConfigJson = "";
         private bool _tabsIndentationJson = false;
         private Vector2 _helpTabScrollPosition = Vector2.zero;
+        private Vector2 _serverTabScrollPosition = Vector2.zero;
 
         [MenuItem("Tools/MCP Unity/Server Window", false, 1)]
         public static void ShowWindow()
@@ -66,6 +67,7 @@ private void OnGUI()
 
         private void DrawServerTab()
         {
+            _serverTabScrollPosition = EditorGUILayout.BeginScrollView(_serverTabScrollPosition);
             EditorGUILayout.BeginVertical("box");
 
             // Server status
@@ -275,15 +277,20 @@ private void DrawServerTab()
                 }
             }
 
-            EditorGUILayout.EndVertical();
-            
+            EditorGUILayout.Separator();
+            EditorGUILayout.Separator();
+
             EditorGUILayout.Space(); 
 
             // Force Install Server button
             if (GUILayout.Button("Force Install Server", GUILayout.Height(30)))
             {
                 McpUnityServer.Instance.InstallServer();
+                McpLogger.LogInfo("MCP Unity Server installed successfully.");
             }
+            
+            EditorGUILayout.EndVertical();
+            EditorGUILayout.EndScrollView();
         }
 
         private void DrawHelpTab()

Editor/UnityBridge/McpUnitySettings.cs

@@ -13,7 +13,7 @@ namespace McpUnity.Unity
     public class McpUnitySettings
     {
         // Constants
-        public const string ServerVersion = "1.0.0";
+        public const string ServerVersion = "1.1.1";
         public const string PackageName = "com.gamelovers.mcp-unity";
         public const int RequestTimeoutMinimum = 10;
 
@@ -58,7 +58,6 @@ public static McpUnitySettings Instance
         private McpUnitySettings() 
         { 
             LoadSettings();
-            VsCodeWorkspaceUtils.AddPackageCacheToWorkspace();
         }
 
         /// <summary>

Editor/Utils/McpUtils.cs

@@ -73,7 +73,9 @@ public static string GetServerPath()
 
             if (packageInfo != null && !string.IsNullOrEmpty(packageInfo.resolvedPath))
             {
-                return Path.Combine(packageInfo.resolvedPath, "Server~");
+                string serverPath = Path.Combine(packageInfo.resolvedPath, "Server~");
+
+                return CleanPathPrefix(serverPath);
             }
 
             var assets = AssetDatabase.FindAssets("tsconfig");
@@ -82,18 +84,20 @@ public static string GetServerPath()
             {
                 // Convert relative path to absolute path
                 var relativePath = AssetDatabase.GUIDToAssetPath(assets[0]);
-                return Path.GetFullPath(Path.Combine(Application.dataPath, "..", relativePath));
+                string fullPath = Path.GetFullPath(Path.Combine(Application.dataPath, "..", relativePath));
+
+                return CleanPathPrefix(fullPath);
             }
             if (assets.Length > 0)
             {
                 foreach (var assetJson in assets)
                 {
                     string relativePath = AssetDatabase.GUIDToAssetPath(assetJson);
                     string fullPath = Path.GetFullPath(Path.Combine(Application.dataPath, "..", relativePath));
-                    
+
                     if(Path.GetFileName(Path.GetDirectoryName(fullPath)) == "Server~")
                     {
-                        return Path.GetDirectoryName(fullPath);
+                        return CleanPathPrefix(Path.GetDirectoryName(fullPath));
                     }
                 }
             }
@@ -106,6 +110,20 @@ public static string GetServerPath()
             return errorString;
         }
 
+        /// <summary>
+        /// Cleans the path prefix by removing a leading "~" character if present on macOS.
+        /// </summary>
+        /// <param name="path">The path to clean.</param>
+        /// <returns>The cleaned path.</returns>
+        private static string CleanPathPrefix(string path)
+        {
+            if (path.StartsWith("~"))
+            {
+                return path.Substring(1);
+            }
+            return path;
+        }
+
         /// <summary>
         /// Adds the MCP configuration to the Windsurf MCP config file
         /// </summary>

README-ja.md

@@ -113,21 +113,25 @@ MCP Unityは、Unityの`Library/PackedCache`フォルダーをワークスペー
 
 ## <a name="install-server"></a>インストール
 
-このMCP Unityサーバーのインストールは複数ステップのプロセスです：
-
-### ステップ1: Unityパッケージマネージャー経由でUnity MCPサーバーパッケージをインストール
-1. Unityパッケージマネージャーを開く（Window > Package Manager）
-2. 左上隅の"+"ボタンをクリック
-3. "Add package from git URL..."を選択
-4. 入力: `https://github.com/CoderGamester/mcp-unity.git`
-5. "Add"をクリック
-
-![package manager](https://github.com/user-attachments/assets/a72bfca4-ae52-48e7-a876-e99c701b0497)
+> [!IMPORTANT]
+> **プロジェクトパスにスペースを含めることはできません**
+>
+> Unity プロジェクトのファイルパスに**スペースを含めない**ことが非常に重要です。
+> プロジェクトパスにスペースが含まれている場合、MCP クライアント（例：Cursor、Claude、Windsurf）は MCP Unity サーバーに接続できません。
+>
+> **例：**
+> -   ✅ **動作します:** `C:\Users\YourUser\Documents\UnityProjects\MyAwesomeGame`
+> -   ❌ **失敗します:** `C:\Users\Your User\Documents\Unity Projects\My Awesome Game`
+>
+> インストールを進める前に、プロジェクトがスペースを含まないパスにあることを確認してください。
 
+このMCP Unityサーバーのインストールは複数ステップのプロセスです：
 
-### ステップ2: Node.jsをインストール
+### ステップ1: Node.jsをインストール
 > MCP Unityサーバーを実行するには、コンピューターにNode.js 18以降がインストールされている必要があります：
 
+![node](docs/node.jpg)
+
 <details>
 <summary><span style="font-size: 1.1em; font-weight: bold;">Windows</span></summary>
 
@@ -156,6 +160,15 @@ MCP Unityは、Unityの`Library/PackedCache`フォルダーをワークスペー
    ```
 </details>
 
+### ステップ2: Unityパッケージマネージャー経由でUnity MCPサーバーパッケージをインストール
+1. Unityパッケージマネージャーを開く（Window > Package Manager）
+2. 左上隅の"+"ボタンをクリック
+3. "Add package from git URL..."を選択
+4. 入力: `https://github.com/CoderGamester/mcp-unity.git`
+5. "Add"をクリック
+
+![package manager](https://github.com/user-attachments/assets/a72bfca4-ae52-48e7-a876-e99c701b0497)
+
 ### ステップ3: AI LLMクライアントを設定
 
 <details open>
@@ -165,7 +178,7 @@ MCP Unityは、Unityの`Library/PackedCache`フォルダーをワークスペー
 2. Tools > MCP Unity > Server Windowに移動
 3. 以下の画像のようにAI LLMクライアントの"Configure"ボタンをクリック
 
-![image](https://github.com/user-attachments/assets/8d286e83-da60-40fa-bd6c-5de9a77c1820)
+![image](docs/configure.jpg)
 
 4. 表示されるポップアップで設定インストールを確認
 
@@ -215,6 +228,9 @@ MCP Unityサーバーを起動するには2つの方法があります：
 1. Unityエディターを開く
 2. Tools > MCP Unity > Server Windowに移動
 3. "Start Server"ボタンをクリック
+4. Open Claude Desktop or your AI Coding IDE (e.g. Cursor IDE, Windsurf IDE, etc.) and start executing Unity tools
+   
+![connect](https://github.com/user-attachments/assets/2e266a8b-8ba3-4902-b585-b220b11ab9a2)
 
 ### オプション2: コマンドラインから起動
 1. ターミナルまたはコマンドプロンプトを開く
@@ -262,3 +278,84 @@ MCP Unityサーバーを起動するには2つの方法があります：
 - Unity Technologies
 - Node.js
 - WebSocket-Sharp
+
+## よくある質問
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">MCP Unityとは何ですか？</span></summary>
+
+MCP Unityは、Model Context Protocol（MCP）を使用して、Unityエディター環境をAIアシスタントLLMツールに接続する強力なブリッジです。
+
+本質的に、MCP Unityは次のことを行います。
+-   Unityエディターの機能（オブジェクトの作成、コンポーネントの変更、テストの実行など）を、AIが理解して使用できる「ツール」および「リソース」として公開します。
+-   Unity内にWebSocketサーバーを、そしてMCPを実装するNode.jsサーバー（UnityへのWebSocketクライアントとして機能）を実行します。これにより、AIアシスタントはUnityにコマンドを送信し、情報を受け取ることができます。
+-   AIアシスタントとの自然言語プロンプトを使用して、Unityプロジェクト内で複雑なタスクを実行できるようにし、開発ワークフローを大幅に加速します。
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">MCP Unityを使用する理由は何ですか？</span></summary>
+
+MCP Unityは、開発者、アーティスト、プロジェクトマネージャーにいくつかの魅力的な利点を提供します。
+
+-   **開発の加速:** AIプロンプトを使用して、反復的なタスクを自動化し、ボイラープレートコードを生成し、アセットを管理します。これにより、創造的で複雑な問題解決に集中する時間を確保できます。
+-   **生産性の向上:** メニューを手動でクリックしたり、簡単な操作のためにスクリプトを作成したりすることなく、Unityエディターの機能と対話できます。AIアシスタントは、Unity内でのあなたの能力を直接拡張します。
+-   **アクセシビリティの向上:** UnityエディターやC#スクリプトの深い複雑さにあまり慣れていないユーザーでも、AIのガイダンスを通じてプロジェクトに意味のある貢献や変更を行うことができます。
+-   **シームレスな統合:** MCPをサポートするさまざまなAIアシスタントやIDEと連携するように設計されており、開発ツールキット全体でAIを活用する一貫した方法を提供します。
+-   **拡張性:** プロトコルとツールセットは拡張可能です。プロジェクト固有またはUnityの機能をAIに公開するための新しいツールとリソースを定義できます。
+-   **コラボレーションの可能性:** AIがチームメンバーが従来行っていたタスクを支援したり、プロジェクトの構造や操作をガイドすることで新しい開発者のオンボーディングを支援したりする新しいコラボレーション方法を促進します。
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">MCP Unityは、今後登場するUnity 6.2のAI機能と比較してどうですか？</span></summary>
+
+Unity 6.2では、以前のUnity Muse（テクスチャやアニメーション生成などの生成AI機能用）やUnity Sentis（Unityランタイムでニューラルネットワークを実行するため）を含む、新しい組み込みAIツールが導入される予定です。Unity 6.2はまだ完全にリリースされていないため、この比較は公開されている情報と予想される機能に基づいています。
+
+-   **焦点:**
+    -   **MCP Unity:** 主に**エディターの自動化と対話**に焦点を当てています。これにより、外部AI（LLMベースのコーディングアシスタントなど）がUnityエディター自体を*制御およびクエリ*して、シーン、アセット、プロジェクト設定を操作できます。これは、エディター内での*開発者のワークフロー*を強化することです。
+    -   **Unity 6.2 AI:**
+        -   エディター内でのコンテンツ作成（テクスチャ、スプライト、アニメーション、動作、スクリプトの生成）と、Unityエディターインターフェースに直接統合された一般的なタスクのAI支援を目的としています。
+        -   UnityのドキュメントとAPI構造に関するあらゆる質問に、Unity環境により正確なカスタマイズされた例で答えるための微調整されたモデル。
+        -   AIモデルの推論を実行する機能を追加し、NPCの動作、画像認識などの機能のために、事前にトレーニングされたニューラルネットワークを*ゲームまたはアプリケーション内*にデプロイして実行できるようにします。
+
+-   **ユースケース:**
+    -   **MCP Unity:** 「新しい3Dオブジェクトを作成し、名前を「Player」にし、Rigidbodyを追加して、質量を10に設定してください。」「すべてのプレイモードテストを実行してください。」「コンソールログのエラーを修正するよう依頼してください。」「カスタムメニュー項目「iOS用のビルドを準備」を実行し、発生する可能性のあるエラーを修正してください。」
+    -   **Unity 6.2 AI:** 「このマテリアルにSFテクスチャを生成してください。」「シーン内のすべてのツリーの位置を「forest」とタグ付けされたテレインゾーン内に配置するように更新してください。」「このキャラクターのアニメーションを作成してください。」「キャラクターを完成させるために2Dスプライトを生成してください。」「コンソールログのエラーの詳細を尋ねてください。」
+
+-   **補完的であり、相互排他的ではない:**
+    MCP UnityとUnityのネイティブAIツールは補完的であると見なすことができます。AIコーディングアシスタントでMCP Unityを使用してシーンを設定したり、アセットを一括変更したりしてから、Unity AIツールを使用して特定のテクスチャを生成したり、アニメーションや2Dスライトをそれらのアセットの1つに作成したりすることができます。MCP Unityは、より広範な外部AIサービスと統合したり、カスタム自動化ワークフローを構築したりしたい開発者にとって強力な、プロトコルベースのエディターとの対話方法を提供します。
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">現在、どのMCPホストとIDEがMCP Unityをサポートしていますか？</span></summary>
+
+MCP Unityは、MCPクライアントとして機能できるAIアシスタントまたは開発環境と連携するように設計されています。エコシステムは成長していますが、現在の既知の統合または互換性のあるプラットフォームには以下が含まれます。
+-  Windsurf
+-  Cursor
+-  GitHub Copilot
+-  Claude Desktop
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">プロジェクトにカスタムツールでMCP Unityを拡張できますか？</span></summary>
+
+はい、もちろんです！MCP Unityアーキテクチャの重要な利点の1つは、その拡張性です。
+-   **Unity内（C#）:** `McpToolBase`（またはリソースの同様のベース）を継承する新しいC#クラスを作成して、カスタムUnityエディター機能を公開できます。これらのツールは、`McpUnityServer.cs`に登録されます。たとえば、プロジェクト固有のアセットインポートパイプラインを自動化するツールを作成できます。
+-   **Node.jsサーバー内（TypeScript）:** 次に、`Server/src/tools/`ディレクトリに対応するTypeScriptツールハンドラーを定義し、入力/出力のZodスキーマを含め、`Server/src/index.ts`に登録します。このNode.js部分は、新しいC#ツールへのリクエストをUnityに転送します。
+
+これにより、AIの機能をゲームやアプリケーションの特定のニーズとワークフローに合わせて調整できます。
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">MCP Unityは無料で利用できますか？</span></summary>
+
+はい、MCP UnityはMITライセンスの下で配布されているオープンソースプロジェクトです。ライセンス条項に従って、自由に利用、変更、配布できます。
+
+</details>
+
+<details>
+<summary><span style="font-size: 1.1em; font-weight: bold;">MCP Unityに接続できないのはなぜですか？</span></summary>