godot-devtool

概述

godot-devtool 是一个全面的 MCP 服务器，通过多种传输路线让 AI 助手能够与 Godot 4 项目进行交互。它提供原生、无头、编辑器和运行时路线，支持项目设置、实时编辑、运行时测试和多实例管理等各种工作流程。服务器使用 stdio 通信，并可选 WebSocket 桥接来实现高级编辑器和运行时功能。它通过项目路径、上下文和会话标识符维护连接状态，允许多个 MCP 客户端高效共享桥接端口。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• get_godot_version

  Get the installed Godot engine version

  试试:What version of Godot is installed?试试:Check Godot version
• get_capabilities

  Get available tools and their schemas with optional filtering

  试试:What tools are available?试试:List all MCP capabilities试试:Get schemas for editor tools
• plugin_install

  Install the godot-devtool plugin in a Godot project

  试试:Install the devtool plugin in my project试试:Add godot-devtool to E:/my-game
• plugin_status

  Check the installation status of the godot-devtool plugin

  试试:Is the devtool plugin installed?试试:Check plugin connection status
• get_project_info

  Retrieve metadata about a Godot project

  试试:Get info about my Godot project试试:Show project metadata
• run_project

  Run the Godot project and capture output

  试试:Run my game试试:Start the Godot project试试:Launch the project
• stop_project

  Stop the currently running Godot project

  试试:Stop the game试试:End the running project试试:Kill the Godot instance
• list_projects

  List Godot projects in a directory

  试试:What Godot projects are in this folder?试试:List all available projects
• project_get_settings

  Read Godot project.godot settings by section or section/key list

  试试:Get project settings试试:Show config settings
• project_set_setting

  Update Godot project.godot settings with dry-run preview

  试试:Change a project setting试试:Update config value
• run_project_checks

  Run stable project checks for CI, review, and release workflows

  试试:Run project validation试试:Check for issues in my project
• browser_visualizer_start

  Start a local read-only dashboard for bridge status and visualization

  试试:Start the visualizer dashboard试试:Open the bridge status page

可对比工具

安装

{
  "mcpServers": {
    "godot-devtool": {
      "command": "node",
      "args": ["E:/godot-devtool/build/index.js"],
      "env": {
        "GODOT_PATH": "D:/Program Files/Godot/Godot_v4.x.exe",
        "GODOT_DEVTOOL_WS_PORT": "8766"
      }
    }
  }
}

git clone https://github.com/wangdiandao/godot-devtool.git
cd godot-devtool
npm install
npm run build

FAQ

桥接的默认 WebSocket 端口是什么？

默认 WebSocket 端口是 8766，可以通过 GODOT_DEVTOOL_WS_PORT 环境变量配置。

这个 MCP 服务器是否需要 Godot 编辑器运行？

不需要，它既支持不需要编辑器的原生/无头路线，也支持需要编辑器或游戏运行的编辑器/运行时路线。

godot-devtool 对比