Unity MCP 統合フレームワーク
2025.04.16
11
C#Unity 集成框架AI 交互工具开发效率
UnityMCP 是一个扩展性强的框架，用于将 Unity 与 Model Context Protocol (MCP) 集成，使 AI 语言模型（如 Claude）能够通过可扩展的命令处理器架构与 Unity 编辑器直接交互。该框架支持 TypeScript 和 C#，提供插件架构、自动命令处理器发现和 TCP/IP 通信等功能。
View on GitHub
Overview
基本能力
产品定位
UnityMCP 是一个用于 Unity 和 Model Context Protocol (MCP) 集成的扩展框架，旨在通过 AI 语言模型增强 Unity 编辑器的交互能力。
核心功能
- 扩展性插件架构：支持自定义命令处理器的创建和注册。
- MCP 集成：基于模型上下文协议与 AI 模型无缝集成。
- 多语言支持：服务器组件使用 TypeScript，Unity 组件使用 C#。
- 编辑器集成：作为可定制的编辑器工具运行。
- 自动发现：自动检测和注册命令处理器。
- 通信机制：通过 TCP/IP 实现 Unity 与外部 AI 服务的通信。
适用场景
- AI 驱动的 Unity 编辑器自动化。
- 扩展 Unity 编辑器的功能。
- 开发与 AI 模型交互的 Unity 应用。
工具列表
- McpServer：监听 TCP 连接并路由命令的核心服务器。
- IMcpCommandHandler：自定义命令处理器的接口。
- McpSettings：管理插件设置。
- McpServiceManager：依赖注入系统。
- McpHandlerDiscovery：自动发现和注册命令处理器。
- HandlerAdapter：将命令处理器适配到 MCP SDK 工具。
- UnityConnection：管理 Unity 的 TCP/IP 通信。
- BaseCommandHandler：实现命令处理器的基础类。
常见问题解答
- 依赖问题：确保安装 Unity 2023.2.19f1 及以上版本，.NET/C# 9.0，以及 Node.js 和 npm。
- 安装问题：使用 Unity 包管理器从 Git URL 安装。
- 连接问题：检查主机和端口配置是否正确。
使用教程
使用依赖
- Unity 2023.2.19f1 或更高版本。
- .NET/C# 9.0。
- Node.js 和 npm（用于 TypeScript 服务器）。
安装教程
- 打开 Unity 包管理器（Window > Package Manager）。
- 点击“+”按钮。
- 选择“Add package from git URL...”。
- 输入：
https://github.com/isuzu-shiranui/UnityMCP.git?path=jp.shiranui-isuzu.unity-mcp。
调试方式
- 打开 Unity，进入 Edit > Preferences > Unity MCP。
- 配置连接设置（主机和端口）。
- 点击“Start Server”开始监听连接。
标签信息
- 安装类型：TCP/IP
- 产品定位：Unity 集成框架、AI 交互工具
- 归类：开发效率