LayaAir-MCP 插件上手指南：让 AI 直接操控你的 LayaAir IDE

之前写过 LayaIdea 和 LayaAir-CodingMCP一个是 IDE 内置 AI 助手一个是给外部 AI 工具用的云端知识库。这篇讲第三个形态LayaAir-MCP 插件——它把 LayaAir IDE 本身暴露成一个本地 MCP 服务让 AI 不仅能查文档、写代码还能直接点 IDE 的菜单、改场景、写文件、跑流程。一句话概括AI 终于能真正“操作”你的 LayaAir IDE 了而不只是“给你建议”。下面按真实安装配置流程走一遍所有截图来自 LayaAir IDE 3.4.0 WorkBuddy跟着配就能用。一、LayaAir-MCP 是什么能干什么LayaAir-MCP 是官方 IDE 插件启动后会在本地开一个 MCP 服务默认端口18188把 IDE 的能力封装成 MCP 工具暴露给外部 AI。AI 工具连接上之后能干的事包括直接操作 IDE / 场景编辑器你说“场景里加个节点挂个 RigidBody”AI 直接调 IDE 命令创建节点并挂载组件。你说“把这个 Sprite 的贴图换成 xxx”AI 直接改资源引用。摆场景、调属性、导资源包都能一句大白话完成。文件写入只要指令涉及 IDE 操作AI 会自动调 IDE 功能写.ts、.lh、.ls等文件不用你手动去编辑器里点。跑完整开发流程场景搭建、预制体制作、资源管理、运行调试、构建发布——AI 在对话里就能驱动。AI 工具连接上后它自己也会这样解释核心就一句话让 AI 直接操控 LayaAir IDE你不用再学 IDE 菜单怎么点。它跟 LayaAir-CodingMCP 是互补关系能力LayaAir-MCP本地LayaAir-CodingMCP云端操作 IDE / 场景✅ 直接控制❌ 不能查询真实 API✅ 通过云端配置可接入✅ 核心能力写文件/改资源✅ 自动❌ 不能运行/调试/构建✅ 可驱动❌ 不能所以最佳组合是本地 LayaAir-MCP 负责操作 IDE云端 CodingMCP 负责查 API 写对代码。后文也会讲怎么把两者同时挂上。二、从 IDE 商城安装插件1. 打开开发者商城在 LayaAir IDE 顶部菜单栏点击帮助 - 开发者商城。开发者商城是 LayaAir IDE 内置的资源/插件市场。2. 搜索并安装 LayaAir-MCP在商城搜索框输入mcp找到LayaAir-MCP | AI辅助开发插件点击安装。这个插件是免费的由 LayaAir 官方发布。认准官方插件名字里带“AI辅助开发”当前免费。3. 导入插件资源安装完成后会弹出资源导入窗口默认把editorResources、engine、libs、src、package等文件全选上。直接点导入…即可。这些文件是插件运行必需的默认全选导入不要漏掉。三、重启 IDE 并打开 MCP 设置插件导入后IDE 需要重新加载插件。点击顶部菜单开发者 - 刷新编辑器快捷键⌘ R/Ctrl R等 IDE 重启完成。不重启的话 MCP 插件不会生效这一步别省。重启后顶部菜单会出现AI服务 - MCP Server Settings点击打开配置面板。MCP Server Settings 是本地 MCP 服务和云端知识库的统一的配置入口。四、配置本地 MCP 服务与云端知识库1. 服务配置打开后第一步是服务配置本地 MCP 服务器端口默认18188没有冲突的话不用改。云端知识库 API_KEY填 Layabox 控制台创建的 API Key。这个 Key 同时用于 LayaIdea、CodingMCP、Cursor/Claude 等工具认证。本地端口默认 18188云端 API_KEY 用于访问 LayaAir 知识库获取方式见下一节。2. 获取 API Key如果没有现成的 Key点右边的获取 API_KEY会跳到 Layabox 控制台。在接口秘钥页面点击 新建 Key创建后立即复制保存。Key 明文只显示一次丢了只能重建。同一个 API Key 可用于 LayaIdea、Claude Code、Cursor 等多种工具的认证。⚠️ 注意API Key 是访问 Layabox 所有服务的凭证不要泄露到公开仓库或截图里。五、自动集成 Cursor / Claude Desktop / Claude Code服务配置完成后下一步是环境自动集成。这里会检测你电脑上安装了哪些支持 MCP 的 AI 工具并自动注入配置和规则。目前支持 Cursor、Claude Desktop、Claude Code全部勾选后点“确定并自动配置”。勾选你要接入的 AI 工具点击确定并自动配置。下方会预览一条name: layaAir的规则提示词告诉 AI 什么时候该调用 LayaAir 相关工具。然后 MCP 服务会启动并把配置写入这些工具的配置文件。日志里看到“MCP 服务器启动成功端口18188”和“Cursor / Claude Desktop / Claude Code 配置完成”就说明自动配置成功了。这里建议勾选跟随 IDE 启动这样每次打开 LayaAir IDE本地 MCP 服务会自动启动AI 工具随时能连上。六、在 WorkBuddy 等 AI 工具里手动接入如果你用的不是 Cursor/Claude而是 WorkBuddy 或其他支持自定义 MCP 连接的 AI 工具就需要手动配置一下。逻辑是一样的让 AI 工具连接http://127.0.0.1:18188/ai/mcp这个本地 SSE 服务。1. 在 AI 工具里指定使用 18188 端口的 Laya MCP以 WorkBuddy 为例直接告诉它“配置使用 18188 端口的 laya mcp”它会自动识别并调用 LayaAir 相关工具。对话里直接说明需求AI 工具会尝试加载对应的 MCP 工具。2. 在 MCP 服务管理中启用 Laya 工具WorkBuddy 有专门的MCP 服务管理页面安装后会看到laya-ide9/9 工具。确保它们处于启用状态否则 AI 无法调用。如果用的是 WorkBuddy记得在自定义连接/连接器管理里把 laya 相关 MCP 服务打开。七、把云端 CodingMCP 也挂上推荐LayaAir-MCP 负责“操作 IDE”但 AI 写代码时还需要准确的 LayaAir API 知识。最稳的做法是同时把云端 CodingMCP也配置进 AI 工具这样 AI 既能操作 IDE又能按真实 API 签名写对代码。1. 在 MCP Server Settings 里复制配置回到 LayaAir IDE 的MCP Server Settings切换到环境配置标签。这里能看到LayaAir 引擎版本例如v3.4.0AI 查询 API 时会按这个版本返回真实签名。云端知识库 API_KEY前面已经填好的 Key。AI 提示词 规则给 AI 的 system prompt让它知道什么时候用 LayaAir 工具。点击复制配置把完整配置文本发给 AI 工具比如 WorkBuddy让它写进mcp.json。复制配置后可以直接粘贴给 AI 工具让它按官方模板写入 mcp.json。2. AI 工具写入 mcp.json 并启用AI 工具拿到配置后会帮你生成类似下面的mcp.json结构配置名类型地址作用laya-idessehttp://127.0.0.1:18188/ai/mcp本地 IDE MCPAI 直接操作 LayaAir IDElaya_mcp_serverhttphttps://laya-knowledge-mcp.layaair.com/mcp云端 CodingMCP按 v3.4.0 查真实 API 写代码两个服务各司其职本地管操作云端管知识库。最后一步在 AI 工具的连接器管理页面把laya-ide和laya_mcp_server都点信任/启用。状态变成connected后对话里就能调用 LayaAir 的 MCP 工具了。AI 工具也会给出同样的下一步建议本地操作工具和云端知识库都开起来AI 才能真正“边查边干”。八、实战让 AI 查一个真实 API全部配好后测试一下。在 WorkBuddy 里输入查下 LocalStorage 用法AI 会通过云端 CodingMCP 查到 LayaAir v3.4.0 的真实 API 签名返回如下云端返回的是 v3.4.0 真实签名知识库已支持到 3.4版本覆盖问题不存在。AI 给出的结果包括方法签名存字符串static setItem(key: string, value: string): void取字符串static getItem(key: string): string | null存对象static setJSON(key: string, value: any): void取对象static getJSON(key: string): any删键static removeItem(key: string): void这只是查询 API 的基础用法。如果加一句“帮我在场景里加个金币节点并用 LocalStorage 存最高分”AI 就会同时调用本地laya-ide工具操作 IDE再用laya_mcp_server查 API最后把代码写进项目。九、常见问题速查Q: LayaAir-MCP 收费吗A: 免费的。Q: 端口 18188 被占用怎么办A: 在 MCP Server Settings 的服务配置里换一个本地端口同时告诉 AI 工具新的端口号。Q: 已经装了 LayaIdea还需要 LayaAir-MCP 吗A: 看场景。LayaIdea 是 IDE 内置面板适合不用离开 IDE 就能完成的对话式开发LayaAir-MCP 是给 Cursor/Claude/WorkBuddy 等外部 AI 用的适合把 LayaAir 开发流程嵌入到你已有的 AI 工作流里。两者可以都用。Q: Cursor/Claude 自动配置失败怎么办A: 检查 AI 工具是否已安装、是否有写入配置文件的权限。也可以手动复制图 14 中的配置粘贴到对应工具的 MCP 配置里。Q: AI 说找不到工具或点了没反应A: 先确认本地 MCP 服务已启动看运行日志再确认 AI 工具里laya-ide已启用/信任最后确认18188端口没有被防火墙或代理拦截。写在最后LayaAir-MCP 最大的价值是把 AI 从“副驾驶”变成了“能动手”的助手。它不是在旁边给你建议而是能直接调用 IDE 命令把你那句模糊的自然语言翻译成具体的编辑器操作和代码文件。对于习惯用 Cursor、Claude、WorkBuddy 等 AI 工具写代码的人来说这相当于把 LayaAir IDE 整个变成了 AI 可调用的工具箱。配合云端 CodingMCP 查 API基本可以做到“一句话推进开发”。