Unity MCP Server Integration

What does “Unity” MCP Server do?

The Unity MCP Server acts as a bridge between the Unity Editor game engine and various AI Model clients such as Claude Desktop, Windsurf, and Cursor. By connecting AI assistants to the Unity Editor, it enables automation, intelligent assistance, and enhanced development workflows within the Unity environment. Developers can leverage this server to enable tasks like code generation, project management, asset manipulation, or automated testing directly from AI models. The server empowers seamless integration between Unity and external AI tools, streamlining development, reducing manual repetitive actions, and boosting productivity for game developers and technical artists.

List of Prompts

No information about prompt templates was found in the repository.

List of Resources

No explicit list of MCP resources is documented in the repository.

List of Tools

No explicit list of tools or detailed server.py code is visible in the repository overview.

Use Cases of this MCP Server

• Automated Code Generation: AI clients can generate Unity C# scripts and insert them directly into the project, saving developers time on boilerplate and common coding tasks.
• Asset Management: Automate asset importing, organization, or modification via AI-driven commands, reducing manual project setup.
• Project Configuration: Quickly configure Unity project settings or build configurations through AI instructions instead of navigating menus.
• Testing and Debugging: Trigger play mode, run tests, or gather logs automatically via AI, streamlining the QA process.
• Scene Manipulation: Directly modify or generate scenes, objects, and components from AI suggestions, enhancing rapid prototyping.

How to set it up

Windsurf

1. Ensure Node.js and Unity Editor are installed.
2. Open your Windsurf configuration file.
3. Add the Unity MCP Server with the following JSON snippet in your mcpServers section:

   {
     "unity-mcp": {
       "command": "npx",
       "args": ["@unity/mcp-server@latest"]
     }
   }
   

4. Save the configuration file and restart Windsurf.
5. Verify Unity MCP Server is running and accessible.

Securing API Keys:

{
  "unity-mcp": {
    "command": "npx",
    "args": ["@unity/mcp-server@latest"],
    "env": {
      "UNITY_LICENSE_KEY": "${UNITY_LICENSE_KEY}"
    },
    "inputs": {
      "api_key": "${UNITY_LICENSE_KEY}"
    }
  }
}

Claude

1. Make sure Node.js and Unity Editor are set up.
2. Locate Claude’s configuration file.
3. Add Unity MCP Server under mcpServers:

   {
     "unity-mcp": {
       "command": "npx",
       "args": ["@unity/mcp-server@latest"]
     }
   }
   

4. Save changes and restart Claude.
5. Confirm connection to the server.

Cursor

1. Install Node.js and Unity Editor if not already present.
2. Open Cursor’s settings/configuration JSON.
3. Add the server:

   {
     "unity-mcp": {
       "command": "npx",
       "args": ["@unity/mcp-server@latest"]
     }
   }
   

4. Save and restart Cursor.
5. Check that the Unity MCP Server appears in available servers.

Cline

1. Ensure Node.js and Unity Editor are installed.
2. Edit the Cline config file.
3. Insert:

   {
     "unity-mcp": {
       "command": "npx",
       "args": ["@unity/mcp-server@latest"]
     }
   }
   

4. Save and restart Cline.
5. Test the server connection.

Note: Always use environment variables (e.g., UNITY_LICENSE_KEY) to store sensitive information like API keys.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "unity-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “unity-mcp” to the actual name of your MCP server and replace the URL with your own MCP server URL.

Overview

Based on the documented information and the structure of the repository, MCP Unity provides a solid integration concept but lacks in-depth public documentation of prompts, tools, and resources. Its clear focus on Unity and the presence of a license and configuration examples are strong points, but the lack of specifics limits its immediate utility without further exploration.

MCP Score