Antigravity Unity

Control Unity with AI.

This project implements a Model Context Protocol (MCP) server that acts as a bridge between AI agents (like Claude Desktop, Cursor, or custom LLM clients) and the Unity Engine.

It allows an AI to see, create, modify, and control everything in your Unity scene in real-time.

🌟 Features

• God Mode Control: Create primitives, instantiate prefabs, set parents, rotate, scale, and move objects.
• Editor & Play Mode: Works in both! Modify the scene while the game is running or while editing level design.
• Full Reflection: Inspect components, read fields, and modify values (int, float, bool, string, Vector3) dynamically.
• Logic Execution: Invoke any public method on any component.
• Tag Management: Create and assign tags on the fly.
• Cleanup Tools: Delete objects to reset scenes.

🛠️ Installation

1. Unity Setup (/Assets)

1. Copy the Assets/Scripts/MCP folder into your Unity project.
2. Add the MCPBridge script to any GameObject in your scene (or create an empty one named "MCPBridge").
3. The server runs on http://localhost:8080.

2. Running the Server

Option A: The Easy Way (Unity Editor)

1. In Unity, click Tools > Unity MCP Server in the top menu.
2. Click the green Start Server button.
3. A terminal window will open showing the server logs.

Option B: The Manual Way (Terminal)

1. Navigate to the mcp-server folder.
2. Run npm install (first time only).
3. Run npm start.

3. Client Configuration

Add the server to your MCP Client config (e.g., claude_desktop_config.json). Important: You need to point to the built file.

{
  "mcpServers": {
    "unity": {
      "command": "node",
      "args": ["E:/GAME UNITY/MCP SERVER/mcp-server/dist/index.js"] 
    }
  }
}

(Note: Replace the path with the actual absolute path to your project)

📚 Available Tools

Tool	Description
create_primitive	Spawn basic shapes (Cube, Sphere, etc.)
instantiate_prefab	Spawn complex assets from Resources
set_object_transform	Move objects (Position)
set_object_rotation	Rotate objects (Euler Angles)
set_object_scale	Resize objects
set_parent	Organize hierarchy
inspect_component	Read public variables of a script
edit_component	Change variable values (speed, health, etc.)
invoke_method	Call functions (Jump(), Attack(), Reset())
add_tag / set_object_tag	Manage tags
delete_object	Remove objects from the scene

📝 Example Prompts

• "Create a red cube and place it at (0, 5, 0)."
• "Build a tower of 10 spheres stacked on top of each other."
• "Inspect the PlayerController on the 'Hero' object and set speed to 20."
• "Make the 'Main Camera' look at the 'Hero'."

⚠️ Requirements

• Unity 2020.3 or later (tested on 6000.0.26f1).
• Node.js 16+.