MCP Server Extension for Unity

A plugin that extends the MCP Server built into JetBrains Rider. Adds tools for operating Unity Editor from any Coding Agents.

Features

• No per-project MCP server package required — no need to install an MCP server package into each Unity project.
• No agent configuration — if the MCP Server is already enabled in Rider, Coding Agents can use the tools immediately with no additional setup.
• No additional configuration required for cloned workspaces — if you clone a workspace with git workspace, claude --workspace, etc., you get tools that work without any additional configuration.
• Tools for Unity Editor — provides Run tests, Run method, Check compilation, and Play control.

Requirements

• JetBrains Rider 2025.3+

Provided Tools

Run Tests

The run_unity_tests tool runs tests on Unity Editor through Rider's test infrastructure. Recommend filtering by assemblyNames, categoryNames, groupNames, and testNames to narrow down the tests to the scope of changes.

Parameters

Response

Error Response

Run Method

The run_method_in_unity tool invokes a static method in Unity Editor via reflection. You can use this tool to edit scenes and prefabs.

Console logs during the method will be captured and returned in the logs field of the response.

Parameters

The method must be static and parameterless.

Response

Error Response

[!IMPORTANT]
The method's return value is NOT returned. success only indicates whether the method was found and invoked (reflection succeeded). Even if the method throws internally, success may be true — the exception is captured in the logs field.

[!IMPORTANT]
Async methods can be invoked, but the tool does not await their completion. Logs generated after the method returns to the caller will not be included in the response.

Check Compilation

The get_unity_compilation_result tool triggers Unity's AssetDatabase.Refresh() and checks if compilation succeeded. Console logs during compilation will be captured and returned in the logs field of the response.

Parameters: none

Response

Error Response

[!WARNING]
If the Unity Editor was compiled before this tool triggered a refresh, the response will not include a log. Compilation errors will remain in the console window, but will not be available with this tool. Instead, use the getDiagnostics or get_file_problems tools, or read editor.log.

[!TIP]
Recommended to run this tool to ensure compilation succeeds before run_unity_tests or run_method_in_unity tool if modified code.

Play Control

The unity_play_control tool controls Unity Editor's play mode.

Parameters

Response

Error Response

Architecture

Coding Agent (e.g., Claude Code)
    ↓ MCP (HTTP/SSE)
JetBrains MCP Server (built into Rider 2025.2+)
    ↓ extension point (com.intellij.mcpServer)
[This Plugin — Kotlin Frontend]
    ├── UnityEditorToolset.kt (facade → CompilationResultTool / RunUnityTestsTool / RunMethodInUnityTool / PlayControlTool)
    │       ↓ (unity_play_control, get_unity_compilation_result, run_method_in_unity)
    │   FrontendBackendModel.playControls / FrontendBackendModel.runMethodInUnity / UnityTestMcpModel.getCompilationResult
    │       ↓ (run_unity_tests)
    │   UnityTestMcpModel (custom Rd: IRdCall<McpRunTestsRequest, McpRunTestsResponse>)
    │       ↓
[Plugin Backend — C# / UnityTestMcpHandler]
    ↓ BackendUnityModel.UnitTestLaunch + RunUnitTestLaunch (existing Rd)
Unity Editor
    ↓ TestRunnerApi.Execute()
Test execution (results via TestResult/RunResult signals)

Rider uses two separate Reactive Distributed (Rd) protocol connections:

• Kotlin Frontend ↔ C# Backend: FrontendBackendModel
• C# Backend ↔ Unity Editor: BackendUnityModel

unity_play_control accesses FrontendBackendModel.playControls directly from Kotlin, requiring no C# backend changes. run_method_in_unity accesses FrontendBackendModel.runMethodInUnity directly from Kotlin, requiring no C# backend changes. run_unity_tests uses a custom Rd model (UnityTestMcpModel) to bridge the two layers, since the Kotlin Frontend cannot directly access BackendUnityModel.

Installation

1. Open Settings > Plugins.
2. Select Marketplace and search for "mcp unity".
3. Click Install on the "MCP Server Extension for Unity" plugin.

Configuration

If the built-in MCP Server is already enabled in Rider, no additional configuration is required.

If it is not yet enabled:

1. Open Settings > Tools > MCP Server.
2. Click Enable MCP Server.
3. Click Auto-Configure for the agent you want to use.

[!NOTE] See the MCP Server documentation for more details on configuration and usage.

Environment Variables

FAQ

Does it only work in the terminal window inside Rider?

No. As long as the Rider process connected to Unity Editor is running, you can use the tools from any coding agent launched in any external terminal.

Can I collect Unity console logs?

No. The only API for retrieving Unity console logs is streaming-based, and MCP tools cannot return streaming responses. While buffering is technically possible, it would be inaccurate and misleading, so this is intentionally not provided. Read editor.log instead.

Contributing

Contributions are welcome. However, the scope is limited to features that use Rider's BackendUnityModel. This plugin does not aim to be an all-in-one Unity toolbox.

[!NOTE]
This project will be closed once JetBrains releases an official MCP extension for Unity.