README

Unity MCP Vibe

The World's First Native C# Model Context Protocol Server

Unity Version Platform MCP Ready License

Give your AI Agent eyes, hands, and zero-latency reflexes inside the Unity Editor.

Unity MCP Vibe is not just a bridge; it's a native organ. Unlike Python-based wrappers that introduce lag and complexity, Vibe runs entirely inside Unity's memory space via native C#, enabling real-time control, visual analysis, and hot-reloading capabilities that were previously impossible.

🚀 Quick Start • 📚 Documentation • 🔧 Toolset • 🤝 Contribute

🌟 Why Vibe? The Native Advantage

Most MCP servers for Unity rely on a slow Python middleman. Unity MCP Vibe eliminates the middleman.

🧠 State-of-the-Art Modules

We have re-engineered the core tools to support modern Unity workflows (DOTS, UI Toolkit, Input System).

👁️ The Eye (Vision Module)

Multimodal AI starts here. Vibe allows your Agent (Claude, Cursor, etc.) to see your Scene and Game View.

• Context-Aware UI Analysis: Detects buttons, labels, and layout issues in UI Toolkit.
• Visual Debugging: AI captures screenshots to diagnose shader or lighting errors instantly.

⚡ Speed Demon (Dynamic Coding)

No more waiting for progress bars.

• Execute C# logic instantly without triggering a full Domain Reload.
• Perfect for tweaking values, spawning test objects, or mass-renaming assets on the fly.

🛡️ The Guardian (Security)

Enterprise-grade safety for autonomous agents.

• Strict Mode: Requires human approval for every write operation.
• Standard Mode: Auto-approves reads, confirms writes/deletes.
• God Mode: Unrestricted access for fully autonomous loops.

📦 Installation

Option 1: Unity Package Manager (Recommended)

1. Open Unity.
2. Go to Window > Package Manager.
3. Click + > Add package from git URL...
4. Paste: https://github.com/jlceaser/Unity-MCP-Vibe.git

Option 2: manifest.json (For Power Users)

Add this line to your Packages/manifest.json:

"com.jlceaser.unity-mcp-vibe": "[https://github.com/jlceaser/Unity-MCP-Vibe.git](https://github.com/jlceaser/Unity-MCP-Vibe.git)"
🚀 Quick Start Guide1. Initialize the ServerGo to System > MCP Control Panel (or press Ctrl+Shift+M).Click Start Server.Status will change to: Listening on http://localhost:8080/sse2. Connect Your AI ClientConfigure your MCP client (Claude Desktop, Cursor, etc.) with the following config:For Claude Desktop (claude_desktop_config.json):JSON{
  "mcpServers": {
    "unity-vibe": {
      "command": "cmd.exe", // or "sh" on Mac/Linux
      "args": [
        "/c",
        "curl -N http://localhost:8080/sse" 
      ]
    }
  }
}
(Note: Direct SSE support varies by client. Detailed connection guides are in the Wiki.)🛠️ Toolset OverviewUnity MCP Vibe comes with 110+ Production-Ready Tools.<details><summary><strong>🎮 Core & Hierarchy</strong></summary>ToolDescriptionmanage_gameobjectCreate, find, reparent, and destroy objects.inspect_componentRead and write public/private fields via Reflection.query_sceneSemantic search for objects (e.g., "Find all enemies near 0,0,0").</details><details><summary><strong>💻 Code & Compilation</strong></summary>ToolDescriptiondynamic_compile(Exclusive) Compile & run C# snippets in memory.script_architectGenerate robust MonoBehaviours with proper namespaces.refactor_assistantAnalyze script dependencies and suggest cleanups.</details><details><summary><strong>🎨 Graphics & Vision</strong></summary>ToolDescriptionvision_captureCapture Game/Scene view as Base64 for AI analysis.material_labCreate and modify URP/HDRP materials programmatically.light_studioAdjust lighting settings and bake handling.</details><details><summary><strong>🔧 Systems & DevOps</strong></summary>ToolDescriptiongit_controlCommit, push, and branch without leaving Unity.package_wizardInstall/Remove UPM packages via registry or git.log_analyzerRead Console logs and auto-suggest fixes for stack traces.</details>⚙️ ConfigurationLocated in ProjectSettings/MCPVibeSettings.asset or via the Control Panel.Port: Default 8080.Auto-Start: Start server automatically when Unity opens.Security Level:🟢 Standard (Recommended)🔴 Strict⚡ Unrestricted🤝 ContributingUnity MCP Vibe is an open ecosystem. We welcome Pull Requests!Fork the repo.Create your feature branch (git checkout -b feature/amazing-feature).Commit your changes.Push to the branch.Open a Pull Request.📜 Credits & LicenseUnity MCP Vibe is a Cedral Interactive initiative, developed by jlceaser.It stands on the shoulders of giants, integrating concepts from:CoplayDev/unity-mcp (Original Concept)RICoder72/vibe-unity (Vision Tools)Licensed under the MIT License. Use it commercially, modify it, build the future.<div align="center"><sub>Built with ❤️ for the Unity Community</sub></div>