unity-mcp

让 AI 直接动手操作 Unity 编辑器,用对话搞定场景和脚本

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 开源模型 🍴 复刻 1629 🐛 待处理 128 👀 关注 81
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 15812
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目,MIT许可证,完全免费,无付费版本。

项目预览

unity-mcp 项目界面预览图
图片来源:项目官网

项目数据

分类开源模型
开发团队CoplayDev
定价模式🏷️完全免费
价格说明开源项目,MIT许可证,完全免费,无付费版本。
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言C#
技术栈/模型ai,ai-integration,anthropic,claude,copilot,cursor,game-development,gamedev,gemini,llm,mcp,model-context-protocol,openai,unity,unity3d,videogames
GitHub 星标★ 15812
上线时间2025-03-18 00:00:00
代码更新2026-10-30
仓库体积45.0 MB
本站数据更新2026-11-09
维护状态较活跃
收录时间2026-08-09
浏览次数4

项目介绍

Unity MCP 是一个开源桥接工具,让 AI 助手(如 Claude、GPT)能直接操控 Unity 编辑器。它通过 Model Context Protocol 协议,为 LLM 提供管理资源、控制场景、编辑脚本和自动化任务的能力。开发者可以用自然语言指令让 AI 在 Unity 中创建物体、调整属性、运行测试,甚至批量处理资源,从而大幅提升游戏开发效率。它解决了传统 AI 无法直接与 Unity 交互的痛点,将 AI 的代码生成能力与 Unity 的实时环境结合,实现从对话到场景变更的闭环。核心能力包括:编辑器内工具调用、场景对象操作、C# 脚本生成与修改、资源导入导出、以及自定义工具扩展。适合希望用 AI 加速原型开发、自动化重复性工作的 Unity 开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 15812

使用教程

难度:入门 约 10 分钟 部署方式:本地安装 3 步

环境要求

  • Unity 2021.3 LTS ~ 6.x
  • Python 3.10+(通过 uv 管理)
  • 任意 MCP 客户端:Claude Desktop/Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等

安装与启动步骤

  1. 1安装 Unity 包

    Unity 打开 Package Manager → Add package from git URL,粘贴下方地址;或使用 openupm 命令安装。可在地址末尾用 #v10.0.0 固定版本。

    openupm add com.coplaydev.unity-mcp
  2. 2配置 MCP 客户端

    回到 Unity 编辑器,打开菜单 Window → MCP for Unity → Configure All Detected Clients,自动写入已检测到的客户端配置。

  3. 3发指令验证

    在 AI 客户端中发送提示,让 AI 在 Unity 中创建物体。若场景内迅速出现立方体并带上刚体,说明桥接已打通。

    Create a cube at the origin and add a Rigidbody.

关键配置

配置项必填说明示例
Package Git URL是在 Unity Package Manager 中添加的 Git 地址,路径指向 /MCPForUnityhttps://github.com/CoplayDev/unity-mcp.git?path=/MCPForUnity

如何确认成功

向 AI 客户端发送“Create a cube at the origin and add a Rigidbody.”,数秒内 Unity 场景出现带 Rigidbody 的立方体即成功。

常见问题

Q:支持哪些 Unity 版本?

A:支持 Unity 2021.3 LTS 一直到 6.x,版本跨度较大,旧项目一般也能直接使用。

Q:可以用哪些 AI 客户端?

A:任何 MCP 客户端都可以,包括 Claude Desktop 与 Claude Code、Cursor、VS Code、Windsurf、Cline、Gemini CLI 等。

Q:Python 环境有什么要求?

A:需要 Python 3.10 或更高版本,并按 README 要求通过 uv 来管理运行环境。

Q:怎么固定版本避免主分支更新?

A:把 Git URL 末尾的 #main 换成发布标签,例如 #v10.0.0,可锁定到对应发行版。

注意事项

  • README 未给出 uv 的安装命令,请自行参考 uv 官方文档完成安装。
  • 默认使用 #main 主分支可能随更新变化,生产环境建议固定到 #v10.0.0 之类的版本标签。
  • 配置由 Configure All Detected Clients 自动完成,需确保 AI 客户端已在同一机器上安装并可被检测到。
  • 更多说明见官方 Wiki:https://coplaydev.github.io/unity-mcp/

核心亮点

  • 直接调用 Unity 编辑器 API,AI 能实时创建/修改场景对象,而非只给代码建议
  • 支持自定义工具扩展,开发者可按需暴露任意编辑器功能给 LLM
  • 基于 MCP 标准协议,可无缝对接 Claude、GPT 等主流 AI 助手

不足之处

  • 依赖网络请求与编辑器通信,复杂场景下可能有延迟或连接不稳定
  • 文档/社区待观察:教程和示例相对有限,高级用法需自行摸索

适用场景

  • 用自然语言快速搭建游戏原型场景,如'生成一个带刚体的立方体'
  • 批量处理资源,如'将所有材质球的颜色改为红色'
  • 辅助编写和重构 C# 脚本,AI 直接修改文件并触发编译

替代项目

Unity-Sentis、Unity-ML-Agents、Copilot for Unity

上一篇:RD-Agent

下一篇:trae-agent

同类项目推荐

user-research-skill 开源

让AI代理帮你自动跑完用户研究全流程

Cookiy AI Skill for AI agents (Claude, Codex, Cursor, OpenClaw) — end-to-end user r···

★ 1568 2026-08-09
Aetox-Harness 开源

本地优先的 Windows AI 工作台,助手加开发者双入口

Aetox harness: a local-first Windows AI environment - model, skills, team and memory···

★ 111 2026-11-05
old-coder 开源

让AI编码代理跑起来验证,不靠读代码靠证据

An old coder's strategy for the agent era: don't read the code — make it run the ga···

★ 757 2026-08-09
wesight 开源

一个桌面应用,一键管理所有 AI 智能体,自动路由模型。

Open-source desktop AI agent workspace with one-click Claude Code, Codex, OpenClaw, ···

★ 969 2026-08-09
AgentChat 开源

多智能体协作+工具调用,快速搭出能干活的任务助手

AgentChat 是一个基于 LLM 的智能体交流平台,内置默认 Agent 并支持用户自定义 Agent。通···

★ 931 2026-09-12
awesome-gamedev-agent-skills 开源

给AI装上游戏引擎大脑,一键生成专业游戏代码

77 game-dev skills for AI coding agents — Godot, Unity, Unreal, Phaser, PixiJS, thr···

★ 7737 2026-08-09
netclaw 开源

说人话就能查网络、改配置、排故障

An AI agent that claws through your network

★ 717 2026-09-12
cloud-mcp-server 开源

让 AI 助手安全执行 AWS 命令,云管理一句话搞定

A lightweight service that enables AI assistants to execute AWS CLI commands (in saf···

★ 186 2026-08-09
openpets 开源

桌面养只宠物,编码状态一眼看穿

Compatibility release mirror for migrated OpenPets installs. Canonical source and re···

★ 4 2026-08-09