MCP.so
登录

UnityMCP VRC

@swax

关于 UnityMCP VRC

MCP Server for Unity with help for creating VRChat worlds

基本信息

分类

其他

许可证

NOASSERTION

运行时

c#

传输方式

stdio

发布者

swax

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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).

概览

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.

FAQ from UnityMCP VRC

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).

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.

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.

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.

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.

评论

其他 分类下的更多 MCP 服务器