Yamu（Unity 的另一个极简 MCP 服务器）是一个实验性的 MCP （模型上下文协议）服务器，使AI编码代理能够与 Unity项目。

特色

• compile_and_wait - 触发Unity编辑器编译，等待完成， 并返回包括任何错误在内的编译结果
• run_tests - 执行Unity测试运行者测试（包括编辑模式和播放模式） 提供实时状态监控和详细结果报告

目的

这个概念验证展示了人工智能编码代理（Claude Code，Gemini CLI 等）可以在 Unity 中自主迭代编辑-编译-调试循环 当通过以下方式提供这些基本编译反馈机制时，开发 MCP。

先修条件

• 平台：macOS（仅测试平台）
• Node.js：运行中间服务器所必需

安装

1.安装该软件包

你可以通过“Keijiro”示范器安装Yamu包（jp.keijiro.yamu） 通过Unity包管理器进行注册表。要将注册表添加到你的项目中， 请遵循[这些说明]。

[这些说明]： https://gist.github.com/keijiro/f8c7e8ff29bfe63d86b888901b82644c

2.将MCP服务器添加到AI代理中

Yamu

Yamu (Yet Another Minimal MCP server for Unity) is an experimental MCP (Model Context Protocol) server that enables AI coding agents to interact with Unity projects.

Features

• compile_and_wait - Triggers Unity Editor compilation, waits for completion, and returns compilation results including any errors
• run_tests - Executes Unity Test Runner tests (both EditMode and PlayMode) with real-time status monitoring and detailed result reporting

Purpose

This proof-of-concept demonstrates how AI coding agents (Claude Code, Gemini CLI, etc.) can autonomously iterate through edit-compile-debug cycles in Unity development when provided with these basic compilation feedback mechanisms via MCP.

Prerequisites

• Platform: macOS (only tested platform)
• Node.js: Required to run the intermediate server

  brew install node
  

Installation

1. Install the Package

You can install the Yamu package (jp.keijiro.yamu) via the “Keijiro” scoped registry using the Unity Package Manager. To add the registry to your project, follow these instructions.

2. Add the MCP Server to the AI Agent

You can either follow the steps in yamu-mcp-setup.md manually, or let the AI agent do it for you. For example, if you’re using Gemini CLI:

You're Gemini CLI. Follow yamu-mcp-setup.md

The “You’re —” statement is important, as some AI agents don’t know what they are unless explicitly told.

Note: You’ll need to update this configuration each time you upgrade Yamu. You can simply run the same prompt again to refresh it.