YetAnotherUnityMcp

YetAnotherUnityMcp

2025.03.31 7

C#Unity 控制AI 交互游戏开发工具开发效率

YetAnotherUnityMcp 是一个基于 Unity 游戏引擎的 Master Control Protocol (MCP) 实现，旨在通过 AI 代理控制和交互 Unity 场景。它通过 TCP 协议实现 Unity 与 AI 工具之间的实时双向通信，支持 JSON 消息和图像数据的交换。该系统将游戏引擎与 AI 逻辑分离，提高了可扩展性和可维护性。

View on GitHub

Overview

基本能力

产品定位

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 客户端设置

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

调试方式

fastmcp dev server/mcp_server.py

许可证

该项目遵循 MIT 开源许可条款。