Unity MCP Lens：为AI Agent打造的高效Unity编辑器桥接方案

Unity MCP Lens是一个专注于token效率、低噪声工具同步和精简模型交互的独立Unity包，旨在解决传统AI Agent集成Unity时面临的上下文窗口被庞大API定义淹没的问题，让Codex、Claude Code等Agent能够更优雅地驱动Unity工作流。

随着大型语言模型能力提升，开发者探索AI Agent直接操作Unity，但传统集成方案需Agent掌握大量Unity内部API，导致上下文窗口膨胀、模型调用复杂度和成本增加。Unity MCP Lens作为窄而深的桥接层，旨在平衡这一核心矛盾。

Unity MCP Lens是独立Unity包（标识符com.becool3000.unity-mcp-lens），可与官方AI Assistant并存。核心组件包括MCP stdio服务器（UnityMcpLensApp目录）、Unity编辑器桥接层（Editor/Lens目录）及事件驱动工具同步机制。其核心设计哲学为噪声控制：默认提供精简工具集，引入detailRef机制实现大型负载按需展开（如场景对象查询先返回摘要+引用，二次查询获取详情），显著降低token消耗。

Lens工具覆盖控制台操作、项目管理、场景编辑等核心领域，组织成会话范围工具包，可动态启用/禁用。明确功能边界：专注本地编辑器操作与开发工作流，不涉及Unity云服务、AI生成资源或官方Assistant特定UI功能。

Lens内置遥测功能，可测量payload大小、上下文噪声水平及控制平面开销，帮助调试Agent行为、识别瓶颈。安装时服务器二进制文件存于用户主目录.unity/unity-mcp-lens/路径，多个项目可共享实例；配置客户端需指向服务器路径，不使用--mcp参数。

Lens与官方AI Assistant互补：官方包提供聊天UI、云端功能及官方工作流集成，Lens专注MCP协议桥接、本地工具及紧凑输出。未来高优先级改进方向：减少桥接层通信开销、保持默认工具集精简、优化工具输出可恢复性。

Unity MCP Lens代表务实的Agent集成哲学：不追求覆盖全部功能，而是通过精心设计的接口层让Agent高效完成常见任务。这种'窄接口'思路在模型上下文稀缺时，通过减少噪声提升信噪比，为AI应用集成提供重要借鉴。