Install
$ agentstack add mcp-zabaglione-mcp-server-unity ✓ scanned · ✓ verified — works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
About
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 はこちら](README-ja.md) | [English](README.md)
🎮 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)
- Download the Extension
- Go to Latest Release
- Download
unity-mcp-server.dxt(42KB)
- Install in Claude Desktop
- Open Claude Desktop
- Go to Extensions
- Click "Install from file"
- Select the downloaded
unity-mcp-server.dxt
- 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)
Click to see manual installation steps
- Clone and build:
``bash git clone https://github.com/zabaglione/mcp-server-unity.git cd mcp-server-unity npm install npm run build ``
- 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:
Creating Scripts
You: "Create a PlayerHealth script that handles damage and healing"
Claude: I'll create a PlayerHealth script for you...
Creating Shaders
You: "I need a water shader with wave animation"
Claude: I'll create a water shader with wave animation...
Organizing Your Project
You: "Set up a folder structure for a platformer game"
Claude: I'll create an organized folder structure for your platformer...
Checking Project Info
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
"Unity server not responding"
- Make sure Unity Editor is open
- Check Window → Unity MCP Server in Unity
- 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](TECHNICAL.md) 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](CONTRIBUTING.md)!
📝 License
MIT License - see [LICENSE](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!
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: zabaglione
- Source: zabaglione/mcp-server-unity
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet — be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.