unity-mcp-template

View on GitHub

Simple template project for controlling Unity via MCP

10 stars C#Others Updated Jun 30, 2026

mcpmcp-clientmcp-servertemplate-projectunitytypescriptunity-mcpai

Documentation

Unity MCP Template

This is a simple example project demonstrating interaction between a TypeScript-based MCP server and Unity. You can build and configure your own tools to expand and develop further.

Create more tools your own!

Quick Start

unity-mcp-sample is a Unity example project. To minimize version-related issues and ensure compatibility with legacy versions, it does not use packages like NewtonsoftJSON. Additionally, the EditorWindow is implemented using IMGUI. The MCP can be managed through the UnityMCP-ShowWindow at the top.

Build MCP Server

within the unity-mcp-server

code

npm install
npm run build

Add MCP in Claude Desktop

Open Claude Desktop Settings, and Developer-Edit Config

code

{
    "mcpServers": {
      "unity-mcp": {
        "command": "node",
        "args":["F:/unity-mcp-template/unity-mcp-server/dist/index.js"]
      }
    }
  }

Create your own tools!

Both input data structure should be same.

Unity

Refer to CreateObjectTools and create the tool you want.

Typescript

Refer to createObject and create the tool you want.

TODO List

[x] Enable Unity to send result messages to MCP
[ ] Discussion here ~~Change TCP structure (currently implemented with client-server reversed due to a bug in the TypeScript SDK)~~
- ~~Unity (Current : TCP Server, TODO : TCP Client)~~
- ~~MCP (Current : TCP Client, TODO : TCP Server)~~

Frequently asked questions

What is unity-mcp-template?

unity-mcp-template is Simple template project for controlling Unity via MCP

How do I install unity-mcp-template?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is unity-mcp-template open source?

Yes — it is hosted on GitHub at https://github.com/dunward/unity-mcp-template and has 10 stars.

Related MCP tools

Unity-MCP

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.

4,137 C#

aiai-integrationgame-development+16

unity-mcp

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

13,915 C#

aiai-integrationmcp+13