← 返回博客
Apr 21, 2026指南作者 Funplay AI

如何在 Godot 4.2+ 项目中通过 res://addons 安装 Funplay Godot MCP

Funplay Godot MCP 通过将插件目录复制到项目的 res://addons/ 路径即可完成安装。该插件在 Godot 4.2 及以上版本中运行,默认在本地 127.0.0.1:8765 端口启动 HTTP 服务。

Funplay MCP for Godot 是 Funplay MCP 家族的旗舰产品,提供 105 个注册工具,是四个仓库中工具数量最多的。当前最新版本为 0.4.0,于 2026 年 4 月 17 日发布。插件完全由 GDScript 编写,仅作为编辑器插件运行,不会在导出的游戏中包含任何运行时组件。它支持 GDScript 项目和 .NET(C#)项目,混合项目会同时显示两套工具。

安装步骤如下:

  1. 从 GitHub 仓库(https://github.com/FunplayAI/funplay-godot-mcp)下载最新版本。
  2. addons/funplay_mcp/ 目录复制到你的 Godot 项目根目录下的 res://addons/ 中。如果 addons 目录不存在,需手动创建。
# 假设你的 Godot 项目路径为 ~/my_godot_project
mkdir -p ~/my_godot_project/addons
cp -r /path/to/downloaded/funplay-godot-mcp/addons/funplay_mcp ~/my_godot_project/addons/
  1. 在 Godot 编辑器中,打开 Project → Project Settings → Plugins
  2. 找到 Funplay MCP for Godot,勾选启用。
  3. 编辑器右侧会出现 Funplay MCP 停靠面板,点击打开。
  4. MCP 服务器将自动在 http://127.0.0.1:8765/ 启动。

对于 AI 客户端配置,插件支持一键配置 Claude Code、Claude Desktop、Cursor、VS Code 和 Codex。手动配置示例(以 Claude Code/Claude Desktop 为例):

{
  "mcpServers": {
    "funplay": {
      "type": "http",
      "url": "http://127.0.0.1:8765/"
    }
  }
}

Funplay Godot MCP 要求 Godot 4.2 或更高版本,低于此版本无法使用。插件仅限于编辑器环境,不会影响导出游戏的构建。如果项目需要严格的网络隔离,注意插件会占用本地 8765 端口,需确保防火墙允许该端口的本地回环通信。对于不使用 MCP 协议的工作流,此插件无实际作用。

在 Godot 4.2+ 项目中集成 Funplay Godot MCP,通过 105 个工具提升编辑器自动化能力。更多 AI 游戏开发实践,请访问 https://gamebooom.ai/zh/blog/。Funplay 家族还提供其他引擎支持:Funplay Unity MCP(79 个工具,支持 Unity 2022.3 及以上)、Funplay Cocos MCP(67 个工具,支持 Cocos Creator 3.8 及以上)以及 Funplay Skills(12 个技能),可在 https://github.com/FunplayAI/ 找到所有仓库。

继续阅读

在你的项目里试试。四个仓库都在 github.com/FunplayAI——挑你在用的引擎,看对应 README。
如何在 Godot 4.2+ 项目中通过 res://addons 安装 Funplay Godot MCP | funplay mcp