docs: improved docs visibility and FAQ

Author: CoderGamester

Editor/Tools/UpdateGameObjectTool.cs

@@ -86,7 +86,7 @@ public override JObject Execute(JObject parameters)
                 {
                     McpLogger.LogWarning($"UpdateGameObjectTool: Tag '{newTag}' does not exist for GameObject '{originalNameForLog}'. Tag not changed. Please create the tag in Unity's Tag Manager.");
                 }
-                else if (targetGameObject.tag != newTag)
+                else if (!targetGameObject.CompareTag(newTag))
                 {
                     targetGameObject.tag = newTag;
                     propertiesUpdated = true;

README-ja.md

@@ -1,15 +1,13 @@
-# MCP Unity エディター (ゲームエンジン)
+# MCP Unity Editor（ゲームエンジン）
 
 [![](https://badge.mcpx.dev?status=on 'MCP 有効')](https://modelcontextprotocol.io/introduction)
 [![](https://img.shields.io/badge/Unity-000000?style=flat&logo=unity&logoColor=white 'Unity')](https://unity.com/releases/editor/archive)
 [![](https://img.shields.io/badge/Node.js-339933?style=flat&logo=nodedotjs&logoColor=white 'Node.js')](https://nodejs.org/en/download/)
+[![](https://img.shields.io/github/stars/CoderGamester/mcp-unity 'スター')](https://github.com/CoderGamester/mcp-unity/stargazers)
+[![](https://img.shields.io/github/last-commit/CoderGamester/mcp-unity '最終コミット')](https://github.com/CoderGamester/mcp-unity/commits/main)
+[![](https://img.shields.io/badge/License-MIT-red.svg 'MIT ライセンス')](https://opensource.org/licenses/MIT)
 
-[![smithery badge](https://smithery.ai/badge/@CoderGamester/mcp-unity)](https://smithery.ai/server/@CoderGamester/mcp-unity)
-[![](https://img.shields.io/github/stars/CoderGamester/mcp-unity 'Stars')](https://github.com/CoderGamester/mcp-unity/stargazers)
-[![](https://img.shields.io/github/last-commit/CoderGamester/mcp-unity 'Last Commit')](https://github.com/CoderGamester/mcp-unity/commits/main)
-[![](https://img.shields.io/badge/License-MIT-red.svg 'MIT License')](https://opensource.org/licenses/MIT)
-
-| [English](README.md) | [🇨🇳简体中文](README_zh-CN.md) | [🇯🇵日本語](README-ja.md) |
+| [英語](README.md) | [🇨🇳簡体中文](README_zh-CN.md) | [🇯🇵日本語](README-ja.md) |
 |----------------------|---------------------------------|----------------------|
 
 ```                                                                        
@@ -45,12 +43,12 @@
 
 MCP Unityは、Unityエディター向けのModel Context Protocolの実装であり、AIアシスタントがUnityプロジェクトと対話できるようにします。このパッケージは、UnityとMCPプロトコルを実装するNode.jsサーバー間のブリッジを提供し、Claude、Windsurf、CursorなどのAIエージェントがUnityエディター内で操作を実行できるようにします。
 
-## 機能
-
 <a href="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity">
   <img width="400" height="200" src="https://glama.ai/mcp/servers/@CoderGamester/mcp-unity/badge" alt="Unity MCPサーバー" />
 </a>
 
+## 機能
+
 ### IDE統合 - パッケージキャッシュアクセス
 
 MCP Unityは、Unityの`Library/PackedCache`フォルダーをワークスペースに追加することで、VSCode系IDE（Visual Studio Code、Cursor、Windsurf）との自動統合を提供します。この機能により：
@@ -278,38 +276,120 @@ MCP Unityサーバーをデバッグするには、以下の方法を使用で
    npm run debug
    ```
 
-## トラブルシューティング
+## Frequently Asked Questions
+
+### What is MCP Unity?
+MCP Unity is a powerful bridge that connects your Unity Editor environment to AI assistants and external tools using the Model Context Protocol (MCP). 
+
+**MCP (Model Context Protocol)** is an open standard designed to allow AI models (like large language models) to interact with software applications and their data in a structured way. Think of it as a universal language that AI can use to "talk" to different programs.
+
+In essence, MCP Unity:
+-   Exposes Unity Editor functionalities (like creating objects, modifying components, running tests, etc.) as "tools" and "resources" that an AI can understand and use.
+-   Runs a WebSocket server inside Unity and a Node.js server (acting as a WebSocket client to Unity) that implements the MCP. This allows AI assistants to send commands to Unity and receive information back.
+-   Enables you to use natural language prompts with your AI assistant to perform complex tasks within your Unity project, significantly speeding up development workflows.
+
+### Why use MCP Unity?
+MCP Unity offers several compelling advantages for developers, artists, and project managers:
+
+-   **Accelerated Development:** Automate repetitive tasks, generate boilerplate code, and manage assets using AI prompts. This frees up your time to focus on creative and complex problem-solving.
+-   **Enhanced Productivity:** Interact with Unity Editor features without needing to manually click through menus or write scripts for simple operations. Your AI assistant becomes a direct extension of your capabilities within Unity.
+-   **Improved Accessibility:** Allows users who are less familiar with the deep intricacies of the Unity Editor or C# scripting to still make meaningful contributions and modifications to a project through AI guidance.
+-   **Seamless Integration:** Designed to work with various AI assistants and IDEs that support MCP, providing a consistent way to leverage AI across your development toolkit.
+-   **Extensibility:** The protocol and the toolset can be expanded. You can define new tools and resources to expose more of your project-specific or Unity's functionality to AI.
+-   **Collaborative Potential:** Facilitates a new way of collaborating where AI can assist in tasks traditionally done by team members, or help in onboarding new developers by guiding them through project structures and operations.
+
+### How does MCP Unity compare with the upcoming Unity 6 AI features?
+Unity 6 is set to introduce new built-in AI tools, including Unity Muse (for generative AI capabilities like texture and animation generation) and Unity Sentis (for running neural networks in Unity runtime). As Unity 6 is not yet fully released, this comparison is based on publicly available information and anticipated functionalities:
+
+-   **Focus:**
+    -   **MCP Unity:** Primarily focuses on **Editor automation and interaction**. It allows external AI (like LLM-based coding assistants) to *control and query the Unity Editor itself* to manipulate scenes, assets, and project settings. It's about augmenting the *developer's workflow* within the Editor.
+    -   **Unity 6 AI (Muse & Sentis):**
+        -   **Muse:** Aims at **in-Editor content creation** (generating textures, sprites, animations, behaviors) and AI-powered assistance for common tasks, directly integrated into the Unity Editor interface.
+        -   **Sentis:** Focuses on **runtime AI model inference**. It allows you to deploy and run pre-trained neural networks *within your game or application* for features like NPC behavior, image recognition, etc.
+
+-   **Mechanism:**
+    -   **MCP Unity:** Uses an external AI assistant communicating via the Model Context Protocol to control the Editor. It's about *external AI driving the Editor*.
+    -   **Unity 6 AI:** These are *native, integrated AI features*. Muse will be part of the Editor's UI/UX, and Sentis is a runtime library.
+
+-   **Use Cases:**
+    -   **MCP Unity:** "Create a new 3D object, name it 'Player', add a Rigidbody, and set its mass to 10." "Find all materials in the project that use the 'Standard' shader." "Run all Play Mode tests."
+    -   **Unity Muse:** "Generate a sci-fi texture for this material." "Create a walking animation for this character." "Help me write a script for player movement."
+    -   **Unity Sentis:** Powering intelligent NPCs in your built game, implementing real-time style transfer, enabling voice commands for players.
+
+-   **Complementary, Not Mutually Exclusive:**
+    MCP Unity and Unity's native AI tools can be seen as complementary. You might use MCP Unity with your AI coding assistant to set up a scene or batch-modify assets, and then use Unity Muse to generate a specific texture for one of those assets. Sentis would then be used for AI logic in the final game. MCP Unity provides a flexible, protocol-based way to interact with the Editor, which can be powerful for developers who want to integrate with a broader range of external AI services or build custom automation workflows.
+
+### What MCP hosts and IDEs currently support MCP Unity?
+MCP Unity is designed to work with any AI assistant or development environment that can act as an MCP client. The ecosystem is growing, but current known integrations or compatible platforms include:
+
+-   **AI Coding Assistants:**
+    -   **Windsurf:** A powerful agentic AI coding assistant that can leverage MCP tools.
+    -   **Cursor:** An AI-first code editor that can integrate with MCP servers.
+    -   Other LLM-based assistants that can be configured to use the MCP protocol.
+-   **IDEs:**
+    -   **Visual Studio Code (VSCode) and variants (like Cursor):** Configuration is typically done by specifying the MCP server details in the IDE's settings, allowing the AI features within these IDEs to connect to MCP Unity.
+-   **MCP Inspector:**
+    -   The `@modelcontextprotocol/inspector` is a tool that can be used to debug and interact with any MCP server, including MCP Unity.
+
+The flexibility of MCP means that as more tools adopt the protocol, they should theoretically be able to interface with MCP Unity. Always check the documentation of your specific AI assistant or IDE for MCP support and configuration instructions.
+
+### How can MCP Unity help with "Generative Engine Optimization" (GEO) for my project?
+"Generative Engine Optimization" (GEO) is an emerging concept, similar to SEO for websites, but for discoverability and usability by generative AI models and AI-powered search engines (like Google's SGE). Here's how MCP Unity helps:
+
+-   **Structured Data Exposure:** MCP tools and resources expose Unity project data (scene hierarchy, assets, components) in a structured, machine-readable format. This makes it easier for AI to "understand" your project.
+-   **Actionable Endpoints:** By providing clear "actions" (tools) the AI can take, MCP Unity allows generative AI to not just read about your project, but to *interact* with and *modify* it. This is key for AI agents that perform tasks.
+-   **Clear Tool Definitions:** The names, descriptions, and parameters of MCP tools (e.g., `update_gameobject`, `add_asset_to_scene`) act like keywords and schemas for AI. Well-defined tools make your project more "AI-friendly."
+-   **Facilitating AI-Driven Content & Code Generation:** While MCP Unity itself doesn't generate game content directly, it enables AI assistants to *orchestrate* the use of Unity's features. For example, an AI could use MCP Unity tools to set up a scene and then prompt you (or potentially another AI service in the future) to generate assets for that scene.
+-   **Standardized Interaction:** Using an open standard like MCP increases the chances that future AI systems and search tools will be able to interface with your project's capabilities exposed via MCP Unity.
+
+Essentially, by making your Unity Editor environment programmatically accessible and understandable to AI through MCP, you are optimizing it for interaction with generative AI engines and AI-driven development workflows.
+
+### Can I extend MCP Unity with custom tools for my project?
+Yes, absolutely! One of the significant benefits of the MCP Unity architecture is its extensibility.
+-   **In Unity (C#):** You can create new C# classes that inherit from `McpToolBase` (or a similar base for resources) to expose custom Unity Editor functionality. These tools would then be registered in `McpUnityServer.cs`. For example, you could write a tool to automate a specific asset import pipeline unique to your project.
+-   **In Node.js Server (TypeScript):** You would then define the corresponding TypeScript tool handler in the `Server/src/tools/` directory, including its Zod schema for inputs/outputs, and register it in `Server/src/index.ts`. This Node.js part will forward the request to your new C# tool in Unity.
+
+This allows you to tailor the AI's capabilities to the specific needs and workflows of your game or application.
+
+### Troubleshooting Common Issues
 
 <details>
-<summary><span style="font-size: 1.1em; font-weight: bold;">接続の問題</span></summary>
+<summary><span style="font-size: 1.1em; font-weight: bold;">Connection Issues</span></summary>
 
-- WebSocketサーバーが実行中であることを確認してください（UnityのServer Windowを確認）
-- ファイアウォールの制限が接続を妨げていないか確認してください
-- ポート番号が正しいことを確認してください（デフォルトは8080）
-- UnityエディターのMCP Serverウィンドウでポート番号を変更できます（ツール > MCP Unity > Server Window）
+- Ensure the WebSocket server is running (check the Server Window in Unity)
+- Send a console log message from MCP client to force a reconnection between MCP client and Unity server
+- Change the port number in the Unity Editor MCP Server window. (Tools > MCP Unity > Server Window)
 </details>
 
 <details>
-<summary><span style="font-size: 1.1em; font-weight: bold;">サーバーが起動しない</span></summary>
+<summary><span style="font-size: 1.1em; font-weight: bold;">Server Not Starting</span></summary>
 
-- Unityコンソールにエラーメッセージがないか確認してください
-- Node.jsが正しくインストールされ、PATHで利用可能であることを確認してください
-- Serverディレクトリ内の依存関係がすべてインストールされていることを確認してください
+- Check the Unity Console for error messages
+- Ensure Node.js is properly installed and accessible in your PATH
+- Verify that all dependencies are installed in the Server directory
 </details>
 
 <details>
-<summary><span style="font-size: 1.1em; font-weight: bold;">Play Modeテスト実行時の接続失敗</span></summary>
+<summary><span style="font-size: 1.1em; font-weight: bold;">Connection failed when running Play Mode tests</span></summary>
 
-`run_tests` ツールは以下の応答を返します：
+The `run_tests` tool returns the following response:
 ```
 Error:
 Connection failed: Unknown error
 ```
 
-このエラーは、Play Modeへ切り替える際にドメインリロードが発生し、ブリッジ接続が失われるために発生します。  
-回避策は、**Edit > Project Settings > Editor > "Enter Play Mode Settings"** で **Reload Domain** をオフにすることです。
+This error occurs because the bridge connection is lost when the domain reloads upon switching to Play Mode.  
+The workaround is to turn off **Reload Domain** in **Edit > Project Settings > Editor > "Enter Play Mode Settings"**.
 </details>
 
+### Where can I find more information or contribute?
+- **Official MCP Unity Repository:** [https://github.com/CoderGamester/mcp-unity](https://github.com/CoderGamester/mcp-unity) (Check for Issues, Discussions, and the Roadmap)
+- **Model Context Protocol Documentation:** [https://modelcontextprotocol.io](https://modelcontextprotocol.io)
+- **Unity Forums and Communities:** For general Unity questions or discussions on integrating AI.
+
+### Is MCP Unity free to use?
+Yes, MCP Unity is an open-source project distributed under the MIT License. You are free to use, modify, and distribute it according to the license terms.
+
 ## サポート・フィードバック
 
 ご質問やサポートが必要な場合は、このリポジトリの[issue](https://github.com/CoderGamester/mcp-unity/issues)をご利用ください。