Advertise
MCP.so
Sign In

UnityMCP VRC MCP Server

@swax

Repository

Basic information

Category

Other

License

NOASSERTION

Transports

stdio

Author

swax

About UnityMCP VRC MCP Server

MCP Server for Unity with help for creating VRChat worlds

UnityMCP VRC MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "unity": {
      "command": "node",
      "args": [
        "C:\\git\\UnityMCP\\unity-mcp-server\\build\\index.js"
      ]
    }
  }
}

UnityMCP VRC MCP Server tools

9

Lists the Unity Editors currently running (name, project, `instanceId`) so you can pick one.

Chooses which Editor subsequent calls target by default (per session); calls can also override with `instance=`.

Compiles and runs LLM-authored C# in the Editor; returns result + logs. Optional `timeoutMs` (default 60s, max 300s) for heavy ops like large imports.

Returns Unity/scene/project state on demand (bounded).

Inspects one GameObject: transform, components, and size info (Renderer bounds, mesh vertex counts, shared mesh/material names).

Returns recent Unity console logs.

Clears the Editor's buffered console logs (e.g. stale errors from a failed snippet) so later `get_logs` reads aren't ambiguous.

Renders the Scene view or game camera to a JPEG/PNG image, so Claude can see the result of edits.

Fetches later pages of any oversized tool result that was paged — `execute_editor_command`, `get_object_details`, `get_editor_state` (used automatically).

Overview

What is UnityMCP VRC?

UnityMCP VRC is a Unity Editor plugin that, together with a Node/TypeScript MCP server, lets Claude (or any MCP client) drive the Unity Editor by running C# commands, reading scene/editor state, and pulling console logs. It is forked from Arodoid/UnityMCP and refactored with a focus on building VRChat / UdonSharp and Basis worlds, though it works for ordinary Unity development as well. It runs on Unity 2022.3 through Unity 6.

How to use UnityMCP VRC?

  1. Build the MCP server by running npm install and npm run build inside the unity-mcp-server directory.
  2. Drag the UnityMCPPlugin/ folder into your Unity project’s Assets/ folder. A UnityMCP menu appears; open the Debug Window and confirm the server is Listening.
  3. Add the stdio MCP server to your client (e.g. Claude Desktop or Claude Code) with the path to build/index.js.
  4. In the Debug Window, verify that an MCP Client row appears once Claude connects. Prompt Claude to start using the tools.

Key features of UnityMCP VRC

  • Run LLM-authored C# with auto-discovered assembly references.
  • Many Unity Editors supported simultaneously via dynamic ports.
  • Bounded state output prevents context window overflow.
  • Take screenshots of Scene/Game view for visual feedback.
  • Survives domain reloads by retrying requests until ready.
  • Live Debug Window shows server status and request queue.

Use cases of UnityMCP VRC

  • Automate repetitive editor tasks (e.g. prefab creation, material assignment).
  • Build and debug VRChat/UdonSharp worlds using natural language instructions.
  • Inspect and modify scene objects without manual inspector navigation.
  • Generate C# scripts and see immediate results in the Unity Editor.
  • Run multiple projects concurrently with different Claude sessions.

Frequently asked questions

1

What Unity versions are supported?

Unity 2022.3 through Unity 6. The command sandbox automatically uses the appropriate compiler (Mono for .NET Framework projects, Roslyn for .NET Standard projects).

2

How do I use multiple Unity Editors at once?

Each Editor hosts its own HTTP server on an OS-assigned dynamic port and publishes itself to a shared registry. Use `list_unity_instances` to discover running Editors and `select_unity_instance` to target one. You can also set `UNITYMCP_INSTANCE` environment variable to pin a session.

3

What happens when Unity domain reloads?

The HTTP listener is dropped momentarily, but the MCP server automatically retries requests until the Editor is back. No persistent socket is torn down, so commands eventually complete.

4

How can I see what the Editor is doing without writing C#?

Use `take_screenshot` to render the Scene or game camera as an image, and `get_object_details` to dump a GameObject’s components, bounds, and material info.

5

Where does the MCP server store discovery data?

Editor instance records are stored in `%LOCALAPPDATA%\UnityMCP\instances\`. This path can be overridden with the `UNITYMCP_REGISTRY_DIR` environment variable.

Comments

More Other MCP servers

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise