RAE AI · MCP

开始使用 RAE AI

MCP 将 AI 代理连接到正在运行的 RAE 编辑器。用自然语言描述任务，代理就能通过编辑器读取和修改游戏数据。

快速开始：3 个步骤

使用 rae-mcp 技能和 RAE MCP 连接。调用 rae_status 检查连接。告诉我连接的是哪个 RAE 实例、打开了哪些游戏文件，以及有哪些可用操作。不要修改或保存任何内容。如果无法连接，请明确说明。

回复应列出实际打开的文件和 RAE 状态。请核对路径是否属于你的项目。如果代理只解释 MCP 的概念，请要求它通过已连接的工具调用 rae_status。

重启 RAE 和代理
安装 MCP 后，完全关闭并重新打开 RAE 和安装时选择的代理。请在同一台 Windows 电脑、同一个安装用户账户下运行两者，并保持 RAE 开启。
打开游戏数据
在 RAE 中打开项目数据，例如 elements.data。查询任务、商城或刷新点需要相应文件。首次尝试修改时，可以使用项目副本。
开始新对话
打开 Codex、Claude Code 或其他已连接的代理。选择模型并粘贴下方提示词。如果代理请求使用 rae 工具，请允许本次任务访问。

请把 12345 和物品名称替换为实际值。先检查计划和受影响记录。应用操作会修改编辑器中的数据；保存会写入原文件，也可能包含尚未保存的手动修改。RAE AI 操作的是文件，不是运行中的游戏服务器。部署修改是单独的步骤。

查找物品及其来源

通过 RAE MCP 查找名为“物品名称”的物品。如果有多个结果，列出 ID 让我选择。查明所选物品的获取途径及用途，说明检查了哪些文件、还缺哪些数据。不要修改任何内容。

理解任务

通过 RAE MCP 查找 ID 为 12345 的任务，解释领取条件、完成条件和奖励。根据现有数据检查物品和 NPC 引用。列出发现的问题和未验证的关联。不要修改任何内容。

预览价格调整

通过 RAE MCP 查找商城中物品 ID 为 12345 的商品。如果有多个选项，先列出来。对选中的选项预览在当前价格基础上降价 20%，显示带单位的新旧价格和受影响文件。仅预览，不应用、不保存。

基于已有物品创建副本

通过 RAE MCP 准备复制 ID 为 12345 的物品，命名为“活动奖励”，自动分配空闲 ID。保持原物品不变。显示将复制的内容和保留的引用。仅预览，不应用、不保存。

如果刚才的计划仍然有效，请通过 RAE MCP 应用它。如果数据已变化，先显示新的预览。应用后重新读取修改的记录并报告结果。暂时不要保存文件。

RAE 必须运行吗？代理会自动启动它吗？

是的。请自行启动 RAE，并在工作期间保持开启。MCP 服务器运行在编辑器内部，代理通过本地地址连接。安装只添加连接和技能，不会自动启动 RAE。关闭编辑器后，MCP 将不可用。代理可以通过已运行的 RAE 打开支持的游戏文件。

代理找不到 RAE MCP

确认安装时选择了该代理，然后完全重启代理。在 MCP 设置中查找 rae 连接。如果没有，请从 RAE AI 菜单重新安装。安装程序配置的是本地用户；远程或云端会话不会自动连接。

RAE 没有响应

确认 RAE 正在运行且 AI 许可证有效。阅读安装程序或 RAE 的提示：如果 Windows 拒绝保留 MCP 地址，请按提示修复。运行多个 RAE 时，核对第一个请求返回的实例和文件路径。

文件缺失或修改受限

让代理通过 RAE MCP 列出可用文件，并提供 rae_status 中的具体限制原因。在 RAE 中打开需要的文件，或让代理从已发现的文件中选择。支持情况取决于格式、版本和构建。不要通过直接写入游戏文件绕过限制。

使用 Cursor

在安装窗口点击“Cursor：复制用户规则”，粘贴到 Cursor → Customize → Rules。重启 Cursor，再执行第一个请求。

保存或撤销修改

保存时可说：“通过 RAE MCP 保存修改的文件并报告验证结果；保存前列出会一并写入的其他未保存修改。”撤销时可说：“列出 RAE 最近的变更组，准备撤销 [名称] 组。”先核对变更组和可能的冲突。