之前写过 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 工具连接上之后，能干的事包括：

  1. 直接操作 IDE / 场景编辑器

    • 你说“场景里加个节点，挂个 RigidBody”，AI 直接调 IDE 命令创建节点并挂载组件。
    • 你说“把这个 Sprite 的贴图换成 xxx”，AI 直接改资源引用。
    • 摆场景、调属性、导资源包都能一句大白话完成。

  2. 文件写入

    • 只要指令涉及 IDE 操作，AI 会自动调 IDE 功能写 .ts、.lh、.ls 等文件，不用你手动去编辑器里点。

  3. 跑完整开发流程

    • 场景搭建、预制体制作、资源管理、运行调试、构建发布——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-ide（9/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.0，AI 查询 API 时会按这个版本返回真实签名。
  • 云端知识库 API_KEY：前面已经填好的 Key。
  • AI 提示词 & 规则：给 AI 的 system prompt，让它知道什么时候用 LayaAir 工具。

点击 复制配置，把完整配置文本发给 AI 工具（比如 WorkBuddy），让它写进 mcp.json。

在这里插入图片描述

复制配置后，可以直接粘贴给 AI 工具，让它按官方模板写入 mcp.json。

2. AI 工具写入 mcp.json 并启用

AI 工具拿到配置后，会帮你生成类似下面的 mcp.json 结构：

配置名 类型 地址 作用
laya-ide sse http://127.0.0.1:18188/ai/mcp 本地 IDE MCP，AI 直接操作 LayaAir IDE
laya_mcp_server http https://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，基本可以做到“一句话推进开发”。

系列导航： 上一篇：LayaIdea 快速上手指南 —— 在 LayaAir IDE 里把 AI 开发助手跑起来

# MCP # 游戏开发
Logo
https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

cover

AI小说写作软件哪个好？百万字创作者的选型方法论

avatar AI编程社区
cover

GEO优化-GEO CMS系统

avatar AI编程社区
cover

全民AI时代开启：ChatGPT破圈大模型走进大众视野

avatar AI编程社区