Unity MCP Server

Unity MCP Server

site icon
2025.04.30 0
C#Unity集成AI交互开发效率
Unity MCP Server 是一个轻量级的模型上下文协议(MCP)服务器,专为Unity应用程序设计。它提供了一种标准化的方式,使Unity应用程序能够与大型语言模型(LLMs)进行交互。该服务器具有跨平台兼容性、简单的stdio传输方式,并内置了多个Unity特定的工具实现。
View on GitHub

Overview

基本能力

产品定位

Unity MCP Server 是一个专为Unity应用程序设计的轻量级MCP服务器,用于与大型语言模型(LLMs)进行交互。

核心功能

  • 跨平台兼容性(Windows、macOS、Linux)
  • 简单的stdio传输方式,便于集成
  • 内置Unity特定的工具实现
  • 基于官方的MCP C# SDK

适用场景

  • Unity应用程序需要与大型语言模型(LLMs)交互的场景
  • 开发者在Unity项目中集成AI功能的场景
  • 需要快速测试和原型开发的场景

工具列表

  • Echo: 将消息回传给客户端
  • GetServerInfo: 返回服务器信息
  • ProcessJsonData: 处理JSON数据并返回相关信息
  • SimulateGameObjectOperation: 模拟对Unity GameObject的操作

常见问题解答

  • 如何扩展服务器功能? 可以通过创建新的类并添加[McpServerToolType][McpServerTool]属性来扩展服务器功能。
  • 如何与Unity项目集成? 需要将MCP C# SDK添加到Unity项目中,并实现一个客户端连接到该服务器。

使用教程

使用依赖

  • .NET 7.0 SDK 或更高版本
  • Unity 2021.3 或更高版本(用于Unity客户端集成)

安装教程

  1. 克隆仓库: git clone https://github.com/UnitySnippets/unity-mcp-server.git
  2. 构建服务器: cd unity-mcp-server/UnityMcpServer dotnet build
  3. 运行服务器: dotnet run

调试方式

  1. 确保服务器已正确运行
  2. 在Unity项目中实现客户端代码,如示例所示
  3. 使用Debug.Log查看工具调用结果

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。