uMCP

by mika-f

7 stars
334 downloads
Not rated
GitHub

About

uMCP is a server implementation of the MCP protocol, designed for working with the AI in Unity.

Details

Author
mika-f
GitHub stars
7
Downloads
334
Categories
Other

- Safety: prevents AI from executing arbitrary code; only pre‑authorized operations are allowed.
- Extensible: add custom commands using McpServerToolType and McpServerTool attributes.
- Direct Streamable HTTP communication without Python, Node.js, or other runtimes.
- Minimal dependencies – runs entirely inside Unity.

Install the CoreFramework package in Unity (2022.3 LTS or newer) via OpenUPM or Git URL. The MCP server starts automatically when the Unity project runs. Then configure your MCP client (e.g., VSCode Agent Mode, Cursor, CLINE) to point to http://localhost:7225/sse or http://localhost:7225/mcp.

uMCP

uMCP is a server implementation of the MCP protocol, designed for working with the AI in Unity.
It is a minimalistic and efficient server that can be used to connect AI agents to Unity applications.

Features

- Safety: uMCP does not allow the AI ​​to execute arbitrary code, and any and all operations can only be performed through pre-authorized operations.
- Extensible: uMCP is designed to be easily extensible, allowing you to add your own custom commands and operations via McpServerToolType and McpServerTool attribute.
- You can find examples in the Assets/NatsunekoLaboratory/ModelContextProtocol/ManagementTools directory.

How it works (What is different from other MCP implementations)

uMCP could directly communicate with the MCP client using the Streamable HTTP protocol, without any other dependencies.
This allows for a more efficient and lightweight implementation compared to other MCP servers that rely on that requires additional dependencies such as Python, Node.js or other language runtimes.

Your MCP Client <-- Streamable HTTP --> uMCP Server

Installation

Prerequisites

- Unity Editor: Version 2022.3 LTS or newer.
- The MCP client must support Streamable HTTP (e.g., VSCode Agent Mode, Cursor, CLINE, etc.).

1. Install the CoreFramework

Using Unity Package Manager

1. openupm add com.natsuneko.modelcontextprotocol.core-framework
2. Open your Unity project.

Using Git URL

1. Open your Unity project.
2. Go to Window > Package Manager.
3. Click + to Add package from git URL....
4. Enter the URL:

   https://github.com/mika-f/uMCP.git?path=/Assets/NatsunekoLaboratory/ModelContextProtocol/CoreFramework

5. Click Add.
6. The MCP server automatically starts when you run the Unity project.

2. Install the Management Tools (and other packages)

Using Unity Package Manager

- openupm add com.natsuneko.modelcontextprotocol.management-tools
- openupm add com.natsuneko.modelcontextprotocol.vrchat-world-tools

Using Git URL

1. Open your Unity project.
2. Go to Window > Package Manager.
3. Click + to Add package from git URL....
4. Enter the URL:

   https://github.com/mika-f/uMCP.git?path=/Assets/NatsunekoLaboratory/ModelContextProtocol/MagagementTools

5. Click Add.

3. Configure your MCP client

Connect your MCP client that support Streamable HTTP (VSCode Agent Mode, Cursor, CLINE, etc.) to the MCP server.

```bash
http://localhost:7225/sse

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.