使用说明
MCP Unity 编辑程序MCP PC (LLM)
要件
安装
第1步：Node.js安装
MCP Unity要运行服务器，请在计算机上Node.js 18以后必须安装：
Windows
- Node.js下载页面访问
- LTS版本Windows下载安装程序（.msi）（推荐）
- 运行安装程序并遵循安装向导
- PowerShell打开并运行以下步骤确认安装：
node --version
macOS
- Node.js下载页面访问
- LTS版本macOS下载安装程序（.pkg）（推荐）
- 运行安装程序并遵循安装向导
- 单击功能区上Homebrew如果已安装，请执行以下操作：
brew install node@18 - 打开终端并运行以下步骤确认安装：
node --version
步骤2:手动设置
AI客户端MCP配置文件（例如：Claude Desktop的，之claude_desktop_config.json）打开并复制以下文本：
{
"mcpServers": {
"mcp-unity": {
"command": "node",
"args": [
"ABSOLUTE/PATH/TO/Server/build/index.js"
],
"env": {
"UNITY_HOST" : "YOUR_IP_ADDRESS",
"UNITY_PORT" : "YOUR_PORT"
}
}
}
}
启动服务器
MCP Unity启动服务器有两种方法：
选项1：Unity通过编辑器启动
- Unity打开编辑器
- 工具>MCP Unity>服务器窗口に移動
- "Start Server"按钮关闭对话框
选项2:从命令行启动
- 打开终端或命令提示符
- MCP Unity转到服务器目录
- 执行以下命令：
node Server/build/index.js
调试服务器
MCP Unity可以使用以下方法调试服务器：
选项1：Unity使用编辑器调试
- Unity打开编辑器
- 工具>MCP Unity>服务器窗口に移動
- "Debug Server"按钮关闭对话框
选项2:使用命令行调试
- 打开终端或命令提示符
- MCP Unity转到服务器目录
- 执行以下命令：
npm run debug
故障排除
接続の問題
- WebSocket确保服务器正在运行（Unity的Server Window），模板名称将采用不同的格式
- 检查防火墙限制是否妨碍了连接
- 确保端口号正确（默认值为8080）
- Unity编辑的MCP Server可以在窗口中更改端口号（工具>MCP Unity > Server Window）
サーバーが起動しない
- Unity请检查控制台是否有错误信息
- Node.js已成功安装PATH中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积
- Server确保已安装目录中的所有从属关系
Play Modeテスト実行時の接続失敗
run_tests 工具返回以下响应：
Error:
Connection failed: Unknown error
此错误包括：Play Mode中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
解决方法是：编辑>项目设置>编辑器>“进入播放模式设置” 单击功能区上 重新加载域 的双曲正切值。
许可证
项目名称 MIT许可证 下提供。
谢辞
貢献
贡献大欢迎！了解更多信息贡献指南来修改标记元素的显示属性。
许可证
这个项目MIT许可证下的许可证-详细信息许可证请参见文件。
