# unitymcp | いすず | Knowledge Base | Instagit Unity Editor integration with Model Context Protocol (MCP) enabling AI assistants like Claude to interact with Unity projects. Features a TypeScript MCP server and C# Unity plugin with extensible command handler architecture, TCP/IP communication, and dynamic plugin discovery. GitHub Stars: 125 Repository: https://github.com/isuzu-shiranui/unitymcp --- ## Articles ### [How to Configure Advanced Settings for Unity MCP Behavior: Complete Guide](/isuzu-shiranui/unitymcp/how-to-configure-advanced-settings-for-unity-mcp-behavior) Configure advanced Unity MCP behavior settings. Learn to control host, port, auto-start, and handlers programmatically or via Preferences using McpSettings. - Tags: how-to-guide - Published: 2026-03-04 ### [Performance Optimization Tips for Unity MCP Handlers: 7 Proven Techniques](/isuzu-shiranui/unitymcp/what-are-the-tips-for-performance-optimization-in-unity-mcp-handlers) Boost Unity MCP handler performance with 7 proven techniques. Cache metadata, paginate data, and skip system assemblies for responsive, high-frequency editor operations. - Tags: performance - Published: 2026-03-04 ### [How to Troubleshoot Connection Problems with Unity MCP: Complete Diagnostics Guide](/isuzu-shiranui/unitymcp/how-to-troubleshoot-connection-problems-with-unity-mcp) Troubleshoot Unity MCP connection problems by verifying TCP ports, enabling UDP discovery, checking firewalls, and inspecting Unity console logs for quick resolution. - Tags: how-to-guide - Published: 2026-03-04 ### [Security Considerations When Running Untrusted Handlers in Unity MCP: Architecture and Mitigations](/isuzu-shiranui/unitymcp/what-are-the-security-considerations-when-running-untrusted-handlers-in-unity-mcp) Learn Unity MCP security risks from untrusted handlers. Discover architecture vulnerabilities and mitigation strategies to prevent code execution and network threats. - Tags: security - Published: 2026-03-04 ### [How to Manage Connection and Reconnection in Unity MCP: A Complete Guide](/isuzu-shiranui/unitymcp/how-to-manage-connection-and-reconnection-in-unity-mcp) Master Unity MCP connection and reconnection with automatic retries, UDP discovery, and lifecycle management. Explore our complete guide for robust networking. - Tags: how-to-guide - Published: 2026-03-04 ### [Unity MCP Configuration Options in Unity Preferences: Complete Settings Guide](/isuzu-shiranui/unitymcp/what-are-the-configuration-options-for-unity-mcp-in-unity-preferences) Master Unity MCP configuration options in Unity Preferences. Learn to set server host port, UDP discovery, auto start, logging, and command handlers for seamless integration. - Tags: complete-settings-guide - Published: 2026-03-04 ### [How to Create Custom Resource Handlers in Unity MCP: A Complete Implementation Guide](/isuzu-shiranui/unitymcp/how-to-create-custom-resource-handlers-in-unity-mcp) Learn to create custom resource handlers in Unity MCP by implementing IMcpResourceHandler. Our guide details automatic registration for seamless integration. - Tags: how-to-guide - Published: 2026-03-04 ### [How to Create Custom Command Handlers in Unity MCP: A Complete Guide](/isuzu-shiranui/unitymcp/how-to-create-custom-command-handlers-in-unity-mcp) Learn to create custom command handlers in Unity MCP using TypeScript and C#. Implement advanced command logic for your Unity game server and editor with this complete guide. - Tags: how-to-guide - Published: 2026-03-04 ### [How Resources Are Handled in Unity MCP: A Complete Technical Guide](/isuzu-shiranui/unitymcp/how-are-resources-handled-in-unity-mcp) Discover how Unity MCP handles resources with its modular pipeline. Learn about handler discovery, registration, and data transformation for efficient Unity connections - Tags: deep-dive - Published: 2026-03-04 ### [How Commands Are Handled in Unity MCP: A Complete Technical Guide](/isuzu-shiranui/unitymcp/how-are-commands-handled-in-unity-mcp) Explore the seven-stage pipeline for Unity MCP command handling. Learn about dynamic discovery, prefix routing, and TCP socket communication with the Unity Editor. - Tags: how-to-guide - Published: 2026-03-04 ### [UnityConnection Component in TypeScript MCP: Complete Networking Layer Guide](/isuzu-shiranui/unitymcp/what-is-the-unityconnection-component-in-typescript-mcp) Master the UnityConnection component in TypeScript MCP. This TCP server guide details client registration, request/response handling, and UDP auto-discovery for seamless Unity and TypeScript communication. - Tags: deep-dive - Published: 2026-03-04 ### [What Is the McpServer Component in Unity C#? A Complete Technical Guide](/isuzu-shiranui/unitymcp/what-is-the-mcp-server-component-in-unity-csharp) Discover the McpServer component in Unity C#. Learn how this TCP runtime bridge facilitates Editor and MCP client communication for command dispatch and resource fetching. - Tags: deep-dive - Published: 2026-03-04 ### [How Handler Discovery Works in Unity MCP for TypeScript: Automatic Runtime Registration Explained](/isuzu-shiranui/unitymcp/how-does-handler-discovery-work-in-unity-mcp-for-typescript) Discover how Unity MCP automatically registers TypeScript handlers at runtime. Learn about dynamic module import and type guard validation by scanning the compiled handlers directory. - Tags: internals - Published: 2026-03-04 ### [How Handler Discovery Works in Unity MCP for C#: Automatic Registration Explained](/isuzu-shiranui/unitymcp/how-does-handler-discovery-work-in-unity-mcp-for-csharp) Discover how Unity MCP automatically registers C# command and resource handlers via assembly scanning at startup saving you manual setup time. - Tags: internals - Published: 2026-03-04 ### [Unity MCP HandlerAdapter: Bridging Custom Handlers to the MCP SDK](/isuzu-shiranui/unitymcp/what-is-the-role-of-the-handleradapter-in-unity-mcp) Discover how the Unity MCP HandlerAdapter bridges custom handlers to the MCP SDK, registering them as callable tools, accessible resources, and reusable prompts for seamless integration. - Tags: internals - Published: 2026-03-04 ### [How UDP Discovery Enables Automatic Server Detection in Unity MCP](/isuzu-shiranui/unitymcp/how-does-udp-discovery-work-for-automatic-server-detection-in-unity-mcp) Discover how Unity MCP uses UDP broadcast discovery on port 27183 to automatically find TypeScript MCP servers without needing manual IP addresses. Learn how JSON announcements enable seamless TCP connections and simplify serve... - Tags: internals - Published: 2026-03-04 ### [How Unity MCP Implements TCP/IP Communication with TypeScript MCP Servers](/isuzu-shiranui/unitymcp/how-does-tcp-ip-communication-work-between-unity-and-typescript-mcp-server) Discover how Unity MCP implements TCP/IP communication with TypeScript MCP servers using a lightweight JSON protocol for seamless data exchange and automatic reconnection. - Tags: internals - Published: 2026-03-04 ### [Unity MCP Architecture: Key Components of the Model Context Protocol Integration](/isuzu-shiranui/unitymcp/what-are-the-key-components-of-unity-mcp) Discover the Unity MCP architecture. Learn about the C# server plugin and TypeScript client SDK that connect via TCP socket for seamless AI model integration in Unity. - Tags: architecture - Published: 2026-03-04 ### [How Unity MCP Architecture Works: A Deep Dive into the C#-TypeScript Bridge](/isuzu-shiranui/unitymcp/how-does-unity-mcp-architecture-work) Explore the Unity MCP architecture, a C#-TypeScript bridge. Discover how the Unity Editor and TypeScript process communicate via JSON-RPC for AI assistant integration and command execution. - Tags: deep-dive - Published: 2026-03-04 ### [What Is Unity MCP? An Extensible Unity Editor Framework for AI Tool Integration](/isuzu-shiranui/unitymcp/what-is-unity-mcp) Discover Unity MCP an open-source Unity Editor extension that integrates AI language models into your projects via TCP/IP for command execution resource querying and more - Tags: getting-started - Published: 2026-03-04