Unity MCP Template

Name: Unity MCP Template
Author: dunward

@dunward

代码仓库

关于 Unity MCP Template

Simple template project for controlling Unity via MCP

#typescript #ai #unity #mcp #template-project #mcp-server #mcp-client #unity-mcp

基本信息

分类

开发工具

许可证

MIT

运行时

传输方式

stdio

发布者

dunward

配置

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

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Unity MCP Template?

Unity MCP Template is a simple example project that demonstrates interaction between a TypeScript‑based MCP server and Unity. It serves as a starting point for developers to build and configure their own tools that bridge an MCP client (e.g., Claude Desktop) with the Unity editor.

How to use Unity MCP Template?

Clone the repository, navigate to unity-mcp-server, run npm install and npm run build. Then add the built server to Claude Desktop via its Developer‑Edit Config, pointing to the generated index.js file. Open the Unity project and manage the MCP through the “UnityMCP‑ShowWindow” menu item at the top.

Key features of Unity MCP Template

Pre‑configured TypeScript MCP server for Unity
Unity EditorWindow implemented with IMGUI
No dependency on NewtonsoftJSON for broader compatibility
Example tool (CreateObjectTool) to easily extend
Ready‑to‑use integration with Claude Desktop
Open‑source and MIT licensed

Use cases of Unity MCP Template

Prototype an AI‑assisted Unity editor tool that creates objects via natural language
Build custom MCP tools for automating repetitive Unity tasks (e.g., scene setup)
Learn how to connect an MCP server to a game engine for interactive workflows

FAQ from Unity MCP Template

What is the purpose of Unity MCP Template?

It is a minimal example that shows how an MCP server can communicate with Unity. You can use it as a base to create your own Unity‑MCP tools.

How do I add the server to Claude Desktop?

Open Claude Desktop Settings, go to Developer‑Edit Config, and add a JSON entry with the command node and the full path to the compiled index.js file.

How can I create custom tools in this template?

In Unity, reference the existing CreateObjectTools class. In TypeScript, reference the createObject function. Both sides must use the same input data structure.

What are the runtime requirements?

Node.js and npm are required to build and run the TypeScript MCP server. Unity (any version, no NewtonsoftJSON needed) is needed for the example project.

Does the server use a specific transport?

The current implementation uses TCP (with roles reversed due to a TypeScript SDK issue). The TODO list indicates a planned change to a standard client‑server TCP structure.