unity-initial-setup

name: unity-initial-setup description: |- Provides an initial setup for AI Skills, `unity-mcp-cli` command line tool installation and everything else that is helpful to set up at the start of the project. Essential packages, and basic configurations.

This guide walks through installing the unity-mcp-cli command-line tool and using it to set up a Unity project with AI Skills and MCP integration.

unity-mcp-cli requires Node.js ^20.19.0 || >=22.12.0 (Node 21.x is not supported). If you don't have Node.js installed:

Download the installer from https://nodejs.org/ and run it, or use a package manager:

winget install OpenJS.NodeJS.LTS

After installation, verify both node and npm are available:

node --version
npm --version

Install the CLI globally so the unity-mcp-cli command is available system-wide:

npm install -g unity-mcp-cli

Verify installation:

unity-mcp-cli --version

Alternative: Run any command without installing globally using npx:
npx unity-mcp-cli --help

Add the plugin to an existing Unity project:

unity-mcp-cli install-plugin /path/to/unity/project

Enable all tools, prompts, and resources:

unity-mcp-cli configure /path/to/unity/project \
  --enable-all-tools \
  --enable-all-prompts \
  --enable-all-resources

Configure MCP integration for your AI agent (e.g., Claude Code, Cursor, Copilot):

unity-mcp-cli setup-mcp claude-code /path/to/unity/project

List all supported agents:

unity-mcp-cli setup-mcp --list

Generate skill files for your AI agent (requires Unity Editor to be running with the plugin):

unity-mcp-cli setup-skills claude-code /path/to/unity/project

unity-mcp-cli open /path/to/unity/project

Command	Description
`unity-mcp-cli install-plugin <path>`	Install Unity-MCP plugin into a project
`unity-mcp-cli remove-plugin <path>`	Remove Unity-MCP plugin from a project
`unity-mcp-cli configure <path> --list`	List current MCP configuration
`unity-mcp-cli setup-mcp <agent> <path>`	Write MCP config for an AI agent
`unity-mcp-cli setup-skills <agent> <path>`	Generate skill files for an AI agent
`unity-mcp-cli create-project <path>`	Create a new Unity project
`unity-mcp-cli install-unity <version>`	Install a Unity Editor version
`unity-mcp-cli open <path>`	Open a Unity project in the Editor
`unity-mcp-cli run-tool <tool> <path>`	Execute an MCP tool via HTTP API

Add --verbose to any command for detailed diagnostic output.

npm not found: Node.js is not installed or not in your PATH. Reinstall Node.js and restart your terminal.
Plugin not appearing in Unity: After install-plugin, open the project in Unity Editor. The package manager resolves dependencies on project open.
Skills generation fails: Ensure Unity Editor is running with the MCP plugin installed and connected before running setup-skills.