【免费下载链接】unreal-engine-skills-for-claude-code-plugin项目地址https://gitcode.com/gh_mirrors/un/unreal-engine-skills-for-claude-code-plugin点击查看免费下载unreal-engine-skills-for-claude-code-plugin 是一款让 Claude Code 通过 MCP 协议直接操控运行中 Unreal Engine 编辑器的插件覆盖蓝图、材质、Niagara、Sequencer 等 30 工具集。它同样支持 Windows——前提是通过Git Bash或WSL提供 bash 环境。这篇跨平台配置指南带你从零完成 Windows 环境搭建并详解两种方案各自的注意事项。 先搞懂这个插件由什么组成插件包含 4 个主要部分unreal-mcp技能skills/unreal-mcp/SKILL.md教 Claude 如何按需发现并调用编辑器里的数百个工具create-toolset技能skills/create-toolset/SKILL.md编写新工具集的指南unreal-skill技能skills/unreal-skill/SKILL.md创建 Agent Skill 的方法SessionStart hookhooks/unreal-context.sh每次会话启动时自动注入当前是 Unreal 项目的上下文提示官方平台支持为macOS、Linux、Windows通过 Git Bash 或 WSL见 README.md。macOS 和 Linux 开箱即用本文重点讲 Windows。 为什么 Windows 需要装一个 bash这是整个配置流程中唯一的跨平台门槛。插件的 SessionStart hook 是一个 bash 脚本hooks/hooks.json 中定义的执行命令是bash ${CLAUDE_PLUGIN_ROOT}/hooks/unreal-context.sh它在会话startup、resume、clear时运行从当前目录向上查找.uproject等项目标记确认你正处在一个 Unreal 项目里。Windows 原生的 PowerShell 环境默认没有 bash所以你需要自带一个。不过别紧张影响其实很小场景hook 状态MCP 工具状态Git Bash 或 WSL✅ 正常注入项目上下文✅ 正常纯 PowerShell无 bash❌ 跳过少一条上下文提示✅ 仍然正常✅ 前置检查清单开始配置前确认这三项#项目说明1Claude Code已安装并可正常使用2Unreal Editor项目中已启用ModelContextProtocol和AllToolsets两个插件3bash 环境Git for WindowsGit Bash或 WSL二选一即可 方案一Git Bash 配置新手最省事的路线第 1 步安装 Git for Windows安装 Git for Windows 时会自带Git Bash——一个完整的 bash 终端。安装后打开它输入下面命令验证bash --version第 2 步在 Git Bash 中启动 Claude Codecd /c/Projects/MyUEProject # 进入你的 UE 项目根目录 claude两个细节值得注意hook 会从当前目录逐级向上查找项目标记.uproject、GenerateProjectFiles.bat等所以即使从Source/、Content/等子目录启动也能正确识别见 hooks/unreal-context.sh如果你习惯从 PowerShell 启动 Claude Codehook 会因找不到 bash 而跳过——请固定从 Git Bash 启动第 3 步验证 hook 是否生效脚本支持一个调试开关hooks/unreal-context.sh设置后 stderr 会打印它的判断过程export CLAUDE_UE_HOOK_DEBUG1 claude看到类似project root: /c/Projects/MyUEProject (typegame, uprojectMyUE.uproject)的输出说明 hook 已正确识别你的项目。 方案二WSL 配置喜欢 Linux 工具链的读者第 1 步启用 WSL以管理员身份打开 PowerShellwsl --install第 2 步项目放哪里建议把 UE 项目放在 Windows 盘符下如C:\Projects\MyGame在 WSL 中通过/mnt/c/Projects/MyGame访问——避免大小写敏感和跨文件系统 IO 问题。第 3 步⚠️ 处理 WSL2 网络细节最容易踩的坑MCP 服务器运行在Windows 的编辑器里监听localhost:8000而 Claude Code 跑在 WSL2 中。WSL2 默认是 NAT 网络模式此时 WSL 里的127.0.0.1指向的是虚拟机本身连不到 Windows 宿主机。两种解决办法镜像网络模式Windows 11 22H2在%USERPROFILE%\.wslconfig中添加networkingModemirrored重启 WSL 后两侧共享 localhost或手动改地址在 WSL 中运行cat /etc/resolv.conf拿到 Windows 网关 IP把.mcp.json里的127.0.0.1改成该地址WSL 环境下如果连接失败优先检查这一步。 开启 MCP 服务器两种方案通用以下步骤与平台无关都在 Unreal Editor 内完成1️⃣ 启用两个核心插件——打开项目的.uproject文件确认Plugins数组包含{ Name: ModelContextProtocol, Enabled: true }, { Name: AllToolsets, Enabled: true }AllToolsets是全部工具的真正来源——只启用ModelContextProtocol时服务器会启动但不暴露任何工具。2️⃣ 让编辑器启动时自动开启服务器——在Project/Saved/Config/PlatformEditor/EditorPerProjectUserSettings.ini中追加[/Script/ModelContextProtocolEngine.ModelContextProtocolSettings] bAutoStartServerTrue3️⃣ 生成客户端配置——在编辑器控制台按~运行ModelContextProtocol.GenerateClientConfig ClaudeCode这会生成 Claude Code 连接所需的.mcp.json默认地址为http://127.0.0.1:8000/mcp。完整步骤见 skills/unreal-mcp/references/setup.md。 安装插件在 Claude Code 中执行/plugin install unreal-engine-skills-for-claude-codeclaude-plugins-official如果官方 marketplace 不存在先添加再安装/plugin marketplace add anthropics/claude-plugins-official团队项目则把配置提交到.claude/settings.json成员会自动提示启用{ enabledPlugins: { unreal-engine-skills-for-claude-codeclaude-plugins-official: true } }✔️ 五步验证连通性启动编辑器已开启自动启动的话服务器随即运行Output Log 中出现 MCP 服务器启动信息运行/pluginInstalled列表中出现unreal-engine-skills-for-claude-code运行/mcpunreal-mcp显示为已连接直接提问试试List all actors in the current level——能返回演员列表即全链路打通 连接后 Claude 默认只看到list_toolsets、describe_toolset、call_tool三个元工具具体工具按需发现。这是刻意的Tool search设计用于保持上下文精简——看不到几百个工具列表不代表配置有问题。️ 可选安装 unreal_mcp_proxy 保活如果你的引擎版本包含Engine/Plugins/Experimental/ModelContextProtocol/Extras/Proxy可以加装代理编辑器关闭时客户端会话保持打开编辑器重新打开后自动重连。Windows x64 的安装命令在 Proxy 目录下用 PowerShell.\Bin\Win64\unreal_mcp_proxy.exe --mcp-json C:\path\to\.mcp.json install详见 setup.md 第 4 节。⚠️ 跨平台踩坑速查表症状原因解决办法hook 没运行从 PowerShell 启动PATH 无 bash安装 Git for Windows改从 Git Bash 启动用CLAUDE_UE_HOOK_DEBUG1验证日志出现 Failed to listen on port默认端口 8000 被占用控制台执行ModelContextProtocol.StartServer port换端口或修改 ini 中ServerPortNumber之后重新生成.mcp.json某个工具集缺失如 Niagara对应插件未启用或未刷新检查.uproject控制台执行ModelContextProtocol.RefreshToolsWSL 里连不上 Windows 的 MCPWSL2 默认 NAT 模式启用镜像网络模式或把.mcp.json地址改为 Windows 网关 IPhook 日志提示找不到项目标记当前目录不在 UE 项目内cd到含.uproject的项目根目录后重新启动完整故障排查矩阵见 skills/unreal-mcp/references/operations.md。 安全须知三条要记住localhost 不是信任边界同用户下的任何进程都能连上 MCP 服务器共享或不可信机器上不要运行execute_tool_script会执行任意 Python它拥有编辑器完整权限建议避免搭配--dangerously-skip-permissions使用长会话前先提交版本MCP 工具可直接修改、移动甚至删除受版本控制跟踪的资源先保存并提交让工作副本可恢复 附录浏览源码想深入阅读插件实现可以克隆仓库git clone https://gitcode.com/gh_mirrors/un/unreal-engine-skills-for-claude-code-plugin核心文件hooks/unreal-context.sh上下文注入逻辑、hooks/hooks.jsonhook 注册、skills/unreal-mcp/SKILL.md工具发现与调用契约。赞分享【免费下载链接】unreal-engine-skills-for-claude-code-plugin项目地址https://gitcode.com/gh_mirrors/un/unreal-engine-skills-for-claude-code-plugin点击查看免费下载相关推荐编辑器关闭不断连unreal-engine-skills-for-claude-code-plugin的unreal_mcp_proxy代理机制详解编辑器关闭不断连unreal engine skills for claude code plugin的unreal_mcp_proxy代理机制详解 unreClaude Code Action跨平台支持Windows、Linux与macOS环境配置全指南Claude Code Action跨平台支持Windows、Linux与macOS环境配置全指南 Claude Code Action是一款强大的GitHuAI 应用人工智能代码智能体CI/CD代码评审unreal-context.sh源码解析unreal-engine-skills-for-claude-code-plugin的SessionStart Hook如何注入项目上下文unreal context.sh源码解析unreal engine skills for claude code plugin的SessionStart H上一篇从设计系统到代码解析 open-design 仓库中的 Starbucks 风格设计规范与实现下一篇Bit 工具箱指南使用 ellipsis 工具函数截断字符串并追加省略号创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考