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)

$3

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!

$3

Click to see manual installation steps

1. Clone and build:
``bash
git clone https://github.com/zabaglione/mcp-server-unity.git
cd mcp-server-unity
npm install
npm run build
`

2. Configure Claude Desktop:
`json
{
"mcpServers": {
"unity": {
"command": "node",
"args": ["/path/to/mcp-server-unity/build/simple-index.js"]
}
}
}
`

📝 How to Use

Once installed, just talk to Claude naturally:

$3


`
You: "Create a PlayerHealth script that handles damage and healing"
Claude: I'll create a PlayerHealth script for you...
`

$3

`
You: "I need a water shader with wave animation"
Claude: I'll create a water shader with wave animation...
`

$3

`
You: "Set up a folder structure for a platformer game"
Claude: I'll create an organized folder structure for your platformer...
`

$3

`
You: "What Unity version and render pipeline am I using?"
Claude: Let me check your project information...
``

🎯 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

$3

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

$3

- 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

$3

- 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!