MCP Server for Unity

Unity MCP Server

Unity MCP Server lets Claude work with your Unity projects! Create scripts, manage shaders, organize folders - all through natural conversation with Claude.

日本語版 README はこちら | English

🎮 What Can You Do?

Talk to Claude to:

• Create Unity Scripts: "Create a PlayerController script with jump functionality"
• Manage Shaders: "Create a toon shader for my character"
• Organize Projects: "Create a folder structure for my RPG game"
• Get Project Info: "What render pipeline is my project using?"

🚀 Quick Start (Recommended: Claude Desktop Extension)

Option 1: Install via Claude Desktop Extension (Easiest)

1. Download the Extension
   • Go to Latest Release
   • Download unity-mcp-server.dxt (42KB)
2. Install in Claude Desktop
   • Open Claude Desktop
   • Go to Extensions
   • Click "Install from file"
   • Select the downloaded unity-mcp-server.dxt
3. Start Using!
   • Open any Unity project (2019.4 or newer)
   • Install Newtonsoft JSON package in Unity:
     • Open Window → Package Manager
     • Click the "+" button and select "Add package by name..."
     • Enter: com.unity.nuget.newtonsoft-json
     • Click "Add"
   • Ask Claude: "Setup Unity MCP in my project at /path/to/project"
   • Claude will install everything automatically!

Option 2: Manual Installation (For developers)

1. Clone and build:
   git clone https://github.com/zabaglione/mcp-server-unity.git cd mcp-server-unity npm install npm run build
2. Configure Claude Desktop:
   { "mcpServers": { "unity": { "command": "node", "args": ["/path/to/mcp-server-unity/build/simple-index.js"] } } }

📝 How to Use

Once installed, just talk to Claude naturally:

Creating Scripts

Creating Shaders

Organizing Your Project

Checking Project Info

🎯 Features

• ✅ Smart Script Creation - Claude understands Unity patterns and creates proper MonoBehaviours
• ✅ Shader Support - Works with Built-in, URP, and HDRP render pipelines
• ✅ Project Organization - Create, move, and rename folders to keep projects tidy
• ✅ Auto Setup - Claude automatically sets up the Unity integration when needed
• ✅ Safe Operations - All changes are made safely with proper Unity asset handling

🛠️ Troubleshooting

"Unity server not responding"

1. Make sure Unity Editor is open
2. Check Window → Unity MCP Server in Unity
3. Click "Start Server" if it's not running

"Can't find my project"

• Tell Claude the exact path: "My Unity project is at C:/Projects/MyGame"
• Make sure it's a valid Unity project with an Assets folder

Need Help?

• Ask Claude: "Help me troubleshoot Unity MCP"
• Check Issues
• See Technical Documentation for advanced details

🎮 Unity Version Support

• Unity 2019.4+ - Full support
• Unity 6 (6000.0+) - Recommended for best experience
• Works on Windows, macOS, and Linux

📈 Latest Updates (v3.1.1)

• ✅ Fixed render pipeline detection (now correctly identifies Built-in, URP, HDRP)
• ✅ Resolved AssetDatabase synchronization errors
• ✅ Improved file management and Unity integration stability

🤝 Contributing

Want to help improve Unity MCP Server? Check out our Contributing Guide!

📝 License

MIT License - see LICENSE

🙏 Acknowledgments

• Anthropic for Claude and MCP
• Unity Technologies for the amazing game engine
• All our contributors and users!

Ready to supercharge your Unity development with Claude? Download the extension now!