返回 MCP 目录
public公开dns本地运行

yamu

Yamu是一个实验性的MCP服务器项目,旨在让AI编程助手能够与Unity项目进行交互,提供编译和测试功能,支持编辑-编译-调试的自动化循环。

article

README

🚀 Yamu

Yamu(Yet Another Minimal MCP server for Unity)是一个实验性的MCP(模型上下文协议)服务器,它能让AI编码代理与Unity项目进行交互。借助它,AI编码代理可以在Unity开发中更高效地参与到项目流程里。

✨ 主要特性

  • compile_and_wait:触发Unity编辑器进行编译,等待编译完成,并返回包含任何错误信息的编译结果。
  • run_tests:执行Unity测试运行器的测试(包括编辑模式和播放模式),可进行实时状态监控,并提供详细的结果报告。

📚 详细文档

此概念验证展示了在通过MCP提供这些基本编译反馈机制的情况下,AI编码代理(如Claude Code、Gemini CLI等)如何在Unity开发中自主地完成编辑 - 编译 - 调试循环。

📦 安装指南

前提条件

  • 平台:macOS(仅在此平台进行过测试)
  • Node.js:运行中间服务器所需。
brew install node

1. 安装包

你可以通过“Keijiro”作用域注册表,使用Unity包管理器安装Yamu包(jp.keijiro.yamu)。要将该注册表添加到你的项目中,请遵循[这些说明]。 [这些说明]: https://gist.github.com/keijiro/f8c7e8ff29bfe63d86b888901b82644c

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

你可以手动按照[yamu-mcp-setup.md]中的步骤操作,也可以让AI代理为你完成。例如,如果你使用的是Gemini CLI,可以输入以下内容:

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

“你是 ---” 这一表述很重要,因为有些AI代理在没有明确告知的情况下,并不清楚自己的角色。

注意:每次升级Yamu时,你都需要更新此配置。你可以再次运行相同的提示来刷新配置。 [yamu-mcp-setup.md]: Packages/jp.keijiro.yamu/yamu-mcp-setup.md

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端