Unity MCP

What is Unity MCP?

Unity MCP is a Model Context Protocol server that connects Claude AI with Unity projects. It allows developers to list Unity projects, retrieve detailed project information, and access project structure and files directly from Claude.

How to use Unity MCP?

Install via npx unity-mcp@latest (recommended) or clone the repository locally. Add the server to your Claude Desktop configuration in claude_desktop_config.json using the "unity" key under mcpServers. Requires Unity projects configured and the Bun runtime.

Key features of Unity MCP

• List all Unity projects
• Get detailed project information
• Access project structure and files

Use cases of Unity MCP

• Inspecting Unity project metadata from Claude without opening the editor
• Querying project file structure for AI-assisted code analysis
• Integrating Unity project management into AI-powered development workflows

FAQ from Unity MCP

What are the runtime requirements for Unity MCP?

You need Unity with projects configured and the Bun runtime installed.

How do I install and configure Unity MCP?

Run npx unity-mcp@latest and add the server to your Claude Desktop config as shown in the README. Alternatively, clone the repo and run locally with Bun.

Where does Unity MCP output logs?

It emits logs to stderr per the MCP spec. On macOS, Claude Desktop stores them at ~/Library/Logs/Claude.

How can I debug Unity MCP?

Use the MCP Inspector by running bun run inspector from the project root; it provides a browser URL for debugging.

What file does Unity MCP need to access?

It requires access to the projects-v1.json file and proper permissions for Unity project directories.