realvirtual.io MCPServer

让 AI 代理完全控制您的 Unity编辑器——场景、GameObject、组件、仿真、数字孪生等。

概述

realvirtual MCPServer 是一个免费的开源 Unity包，实现了 Model Context Protocol（MCP）。它允许 AI 代理（如 Claude、Cursor 或任何 MCP兼容客户端）与 Unity实时交互。

该包适用于 任何 Unity项目 —— 包括工业数字孪生、机器人仿真和虚拟调试。

工作原理

AI 代理 (Claude Desktop / Claude Code / Cursor)
    |
    | MCP协议 (stdio 或 SSE)
    v
Python MCP Server
    |
    | WebSocket (JSON, 端口 18711)
    v
Unity包 (C# WebSocket 服务器 + 工具注册表)

该包在 Unity编辑器内运行一个 WebSocket 服务器。当 AI 代理发送工具调用时，Python MCP Server 通过 WebSocket 将其转发到 Unity，后者在主线程上执行并返回结果。

主要特性

• 适用于任何 Unity项目 —— 不绑定特定的框架或资源
• 无需 Python 知识 —— 用您已经使用的 C# 语言定义工具
• 自动发现 —— 通过反射找到工具，无需手动注册
• 90+ 个内置工具 —— 场景、GameObject、组件、变换、仿真、截图等
• 几分钟内可扩展 —— 在任何静态方法上添加 [McpTool]，AI 代理即可使用
• 自包含 —— 内置 Python 3.12，无需系统 Python
• 一键设置 —— 从 Unity工具栏下载 Python 服务器并配置 Claude
• 跨域重载存活 —— Unity重新编译脚本后自动重连
• 多实例支持 —— 运行多个 Unity实例，每个实例都有独立的 MCP Server

realvirtual 数字孪生工具

与 realvirtual 框架结合使用时，您将获得专为工业数字孪生和虚拟调试构建的额外 MCP工具：

• 驱动 —— 控制电机、执行器、传送带
• 传感器 —— 读取工业传感器
• PLC信号 —— 读写 PLC I/O
• 机器人 IK（Inverse Kinematics） —— 逆运动学控制

这使 AI 代理能够操作完整的虚拟工厂仿真——实时移动机器人、控制传送带、读取传感器以及与 PLC程序交互。

工具栏状态

工具栏大脑图标显示连接状态：

旁边的活动标签显示当前正在执行的工具调用及其耗时。

链接

• GitHub（Unity包）： github.com/game4automation/io.realvirtual.mcp
• GitHub（Python 服务器）： github.com/game4automation/realvirtual-MCP
• 许可证： MIT