基本能力
产品定位
YetAnotherUnityMcp 是一个桥梁系统，连接 Unity 游戏引擎与 AI 驱动工具，通过 MCP 协议实现 AI 代理对 Unity 场景的实时控制和交互。
核心功能
- 在 Unity 中执行 C# 代码
- 查询 Unity 编辑器状态
- 动态参数处理
- 组织和导航 GameObject 层次结构
- 修改 GameObject 属性
- 实时捕获 Unity 编辑器截图
- 获取 Unity 日志和调试信息
- 提供上下文模板
- 实时 TCP 通信
适用场景
- AI 驱动的 Unity 场景自动化测试
- 游戏开发中的 AI 辅助工具
- 实时监控和调试 Unity 应用
- 教育与研究中的交互式 Unity 演示
工具列表
execute_code_in_unity: 在 Unity 编辑器中运行 C# 代码unity_screenshot: 捕获 Unity 编辑器截图unity_modify_object: 修改 Unity GameObject 属性unity_logs: 获取 Unity 日志
常见问题解答
- 通信协议基于 TCP 套接字，使用简单的帧机制
- 支持连接健康检查的 ping/pong 消息
- 提供 UI 用于监控连接和调试
使用教程
使用依赖
- Unity 2020.3 或更高版本
- Python 3.11
安装教程
Unity 服务器设置
- 打开 Unity 项目
- 导入 YetAnotherUnityMcp 插件
- 启动 TCP 服务器
Python 客户端设置
bash
git clone https://github.com/yourusername/YetAnotherUnityMcp.git
cd YetAnotherUnityMcp
uv venv -p 3.11
source .venv/bin/activate
uv pip install -e ".[dev]"
python -m server.mcp_server
调试方式
bash
fastmcp dev server/mcp_server.py
