\# Unity MCP Server

MCP server to connect Claude with Unity projects. Built using the
\Model Context Protocol SDK\.

Features

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

Installation & Usage

Option 1: Using NPX (Recommended)

You can run this tool directly with npx without installing it:

\\\bash
npx unity-mcp@latest
\\\

Add this tool as an MCP server in Claude:

On MacOS: \~/Library/Application\\ Support/Claude/claude\_desktop\_config.json\
On Windows: \%APPDATA%/Claude/claude\_desktop\_config.json\

\\\json
{
"mcpServers": {
"unity": {
"command": "npx",
"args": \["unity-mcp@latest"\]
}
}
}
\\\

Option 2: Run this project locally

Alternatively, run this project locally by cloning this repo:

\\\bash
git clone https://github.com/your-username/unity-mcp.git
cd unity-mcp
bun install
\\\

Then configure Claude to use your local version:

\\\json
{
"mcpServers": {
"unity": {
"command": "bun",
"args": \["run", "C:\\\\Users\\\\Artga\\\\Code\\\\unity-mcp\\\\src\\\\index.ts"\]
}
}
}
\\\

Requirements

- Unity with projects configured
- Bun runtime

Troubleshooting

Please open an issue if you can't get this MCP working. Here are some tips:

1. Make sure Unity is installed and you have some projects configured
2. Check that the unity-mcp server can access the projects-v1.json file
3. Ensure you have proper permissions for the Unity project directories

This MCP will emit logs to stderr as specified in the MCP spec. On Mac the
Claude Desktop app should emit these logs to \~/Library/Logs/Claude\. On other
platforms
\you can find logs here\.

Development

Setup

\\\bash


Install dependencies

Debugging

Since MCP servers run over stdio, debugging can be challenging. For the best
debugging experience, we strongly recommend using the
\MCP Inspector\.

You can launch the MCP Inspector with this command:

\\\bash
bun run inspector
\\\

Upon launching, the Inspector will display a URL that you can access in your
browser to begin debugging.

License

MIT License - see \LICENSE\ file for details.