mcp-unity
Model Context Protocol (MCP) plugin to connect with Unity Editor — designed for Cursor, Claude Code, Codex, Windsurf and other IDEs
mcp-unity is a Model Context Protocol server that bridges Unity Editor with AI coding assistants, enabling natural-language control of Unity projects. It runs a WebSocket server inside Unity and a Node.js MCP bridge, exposing tools and resources for scene manipulation, GameObject management, asset handling, and test execution. Developers can use AI prompts to automate Unity workflows—creating objects, modifying components, running tests, and managing materials—without manual Editor interaction. The server integrates with Cursor, Claude Code, Windsurf, GitHub Copilot, and other MCP clients.
Key Features
Use Cases
- 01Automate repetitive Unity tasks like creating multiple GameObjects or configuring components through AI prompts
- 02Batch-modify scene hierarchies and GameObject properties without manual Editor clicks
- 03Run and manage Unity test suites directly from AI coding assistants during development
- 04Generate and configure materials, prefabs, and assets using natural language instructions
- 05Debug Unity projects by querying console logs and GameObject state through MCP resources
- 06Onboard new developers by enabling AI-guided Unity project navigation and modifications
Related MCP Servers
View moremarkitdown
Python tool for converting files and office documents to Markdown.
firecrawl
The context API to search, scrape, and interact with the web at scale. 🔥
prompts.chat
f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.
langflow
Langflow is a powerful tool for building and deploying AI-powered agents and workflows.
mcp-unity — FAQ
What is mcp-unity?+
mcp-unity is an MCP server that connects Unity Editor to AI coding assistants, allowing you to control Unity through natural language prompts. It exposes Unity operations like scene management, GameObject manipulation, and test execution as MCP tools that AI assistants can invoke.
How do I install mcp-unity?+
Install Node.js 18+, add the package via Unity Package Manager from git URL https://github.com/CoderGamester/mcp-unity.git, then use the Tools > MCP Unity > Server Window to configure your AI client (Cursor, Claude Code, etc.) or manually add the MCP server config. Start the server from the same Unity window.
Which AI clients work with mcp-unity?+
mcp-unity works with Cursor, Windsurf, Claude Desktop, Claude Code, Codex CLI, GitHub Copilot, Google Antigravity, OpenCode, and any MCP-compatible client. Both global and project-scoped configurations are supported.
What are the prerequisites for mcp-unity?+
You need Unity 6 or later and Node.js 18+ with npm 9+. No API keys are required. The server uses per-project authentication tokens stored in Library/McpUnity/bridge-token for security.
Is mcp-unity free?+
Yes, mcp-unity is open source and distributed under the MIT License. You can use, modify, and distribute it freely.
Can I extend mcp-unity with custom tools?+
Yes, you can create custom C# classes inheriting from McpToolBase in Unity and corresponding TypeScript handlers in the Node.js server. This lets you expose project-specific Unity functionality to AI assistants.
How do I install mcp-unity?+
Open the source repository on GitHub and follow its README. mcp-unity is a mcp server — MCP Agents Market links you directly to the official repo.
Is mcp-unity free?+
mcp-unity is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.