execute_javascript 是 Funplay Cocos MCP 的首要工具，允许 AI 在 Cocos Creator 编辑器上下文中直接执行 JavaScript 代码。它还有两个别名——execute_scene_script 和 execute_editor_script——功能等价，按语义选用即可。
项目背景
Funplay MCP for Cocos（包名 funplay-cocos-mcp）是一个仅编辑器模式的 Cocos Creator 扩展，当前版本 0.1.1，于 2026 年 4 月 16 日发布，采用 MIT 许可证。它总共提供 67 个工具，其中核心配置占 19 个，覆盖脚本执行、项目与场景、节点编辑、资源与预制体、组件、UI、摄像机、动画、文件、诊断、运行时、交互输入、截图与窗口等类别。该扩展要求 Cocos Creator 3.8 或更高版本，不会在最终构建中引入任何运行时依赖。如果你同时关注其他引擎，同系列还有 Funplay Unity MCP（79 个工具）、Funplay Godot MCP（105 个工具）以及 Funplay Skills（12 个技能）。
execute_javascript 的定位与用法
在 Funplay Cocos MCP 的工具体系中，execute_javascript 属于"脚本执行"类别（共 3 个工具）。它的核心价值是让 AI 在编辑器上下文中自由运行任意 JavaScript，从而完成那些没有专用窄工具覆盖的任务。典型工作流包括：
- 提示词转场景：让 AI 创建带邮箱/密码输入框和登录按钮的 UI，MCP 通过
execute_javascript或窄 UI 工具构建节点层级、应用布局并绑定事件处理。 - 播放模式验证：AI 进入预览模式，通过输入模拟驱动 UI，截取屏幕截图并检查日志。
- 资源审计：AI 列出项目资源，识别缺失引用，提出清理建议。
配置方式很简单。以 Claude Code 或 Claude Desktop 为例，在 MCP 服务器配置中加入以下内容：
{
"mcpServers": {
"funplay-cocos": {
"type": "http",
"url": "http://127.0.0.1:8765/"
}
}
}
如果使用 Codex，则用 TOML 格式：
[mcp_servers.funplay-cocos]
url = "http://127.0.0.1:8765/"
传输层基于 HTTP JSON-RPC 2.0，默认地址 http://127.0.0.1:8765/。若该端口被占用，扩展会自动尝试最多 20 个连续端口进行回退。默认无需认证，绑定 127.0.0.1 以限制本地访问，所有工具直接执行，无需逐次审批。
注意事项
首先，execute_javascript 能力非常宽泛，适合快速原型和自动化批处理，但不适合需要类型安全的项目——对生产代码建议使用专用窄工具（节点编辑、组件操作等），这些工具做了参数校验，出错概率更低。其次，该扩展仅作用于编辑器，不会影响最终构建包的体积或依赖。再者，由于所有工具无需逐次确认即直接执行，建议在受控环境中使用，避免对重要项目造成意外修改。最后，端口回退机制意味着首次连接时需确认实际使用的端口号，否则 AI 客户端可能连不上。
延伸阅读
如果你正在使用 Cocos Creator 开发项目并希望通过 AI 加速编辑器工作流，可以前往 Funplay Cocos MCP 主仓库 查看完整文档和安装说明。使用 Unity 的开发者可浏览同系列的 Funplay Unity MCP 仓库。更多引擎相关的 AI 工具实践文章，参见 Gamebooom 博客。