en es ja ko zh

Godot MCP

Name: Godot MCP
Author: Coding-Solo

by Coding-Solo

Overview Schema Source Related Servers Discussions Admin

JavaScript

Godot MCP

使用 Godot 制作

                           (((((((             (((((((                          
                        (((((((((((           (((((((((((                      
                        (((((((((((((       (((((((((((((                       
                        (((((((((((((((((((((((((((((((((                       
                        (((((((((((((((((((((((((((((((((                       
         (((((      (((((((((((((((((((((((((((((((((((((((((      (((((        
       (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((      
     ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((    
    ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((    
      (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((     
        (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((       
         (((((((((((@@@@@@@(((((((((((((((((((((((((((@@@@@@@(((((((((((        
         (((((((((@@@@,,,,,@@@(((((((((((((((((((((@@@,,,,,@@@@(((((((((        
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((        
         ((((((((@@@,,,,,,,,,@@(((((((@@@@@(((((((@@,,,,,,,,,@@@((((((((        
         (((((((((@@@,,,,,,,@@((((((((@@@@@((((((((@@,,,,,,,@@@(((((((((        
         ((((((((((((@@@@@@(((((((((((@@@@@(((((((((((@@@@@@((((((((((((        
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((        
         (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((        
         @@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@((((((((((((@@@@@@@@@@@@@        
         ((((((((( @@@(((((((((((@@(((((((((((@@(((((((((((@@@ (((((((((        
         (((((((((( @@((((((((((@@@(((((((((((@@@((((((((((@@ ((((((((((        
          (((((((((((@@@@@@@@@@@@@@(((((((((((@@@@@@@@@@@@@@(((((((((((         
           (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((          
              (((((((((((((((((((((((((((((((((((((((((((((((((((((             
                 (((((((((((((((((((((((((((((((((((((((((((((((                
                        (((((((((((((((((((((((((((((((((                       
                                                                                

                          /$$      /$$  /$$$$$$  /$$$$$$$ 
                         | $$$    /$$$ /$$__  $$| $$__  $$
                         | $$$$  /$$$$| $$  \__/| $$  \ $$
                         | $$ $$/$$ $$| $$      | $$$$$$$/
                         | $$  $$$| $$| $$      | $$____/ 
                         | $$\  $ | $$| $$    $$| $$      
                         | $$ \/  | $$|  $$$$$$/| $$      
                         |__/     |__/ \______/ |__/

用于与 Godot 游戏引擎交互的模型上下文协议 (MCP) 服务器。

介绍

Godot MCP 使 AI 助手能够启动 Godot 编辑器、运行项目、捕获调试输出并控制项目执行——所有这些都通过标准化界面完成。

这种直接反馈循环可以帮助 Claude 这样的 AI 助手了解在真实的 Godot 项目中什么有效、什么无效，从而提供更好的代码生成和调试帮助。

Related MCP server: Godot MCP server

特征

启动 Godot 编辑器：打开特定项目的 Godot 编辑器
运行 Godot 项目：在调试模式下执行 Godot 项目
捕获调试输出：检索控制台输出和错误消息
控制执行：以编程方式启动和停止 Godot 项目
获取 Godot 版本：检索已安装的 Godot 版本
列出 Godot 项目：在指定目录中查找 Godot 项目
项目分析：获取有关项目结构的详细信息
场景管理：
- 创建具有指定根节点类型的新场景
- 将节点添加到具有可自定义属性的现有场景
- 将精灵和纹理加载到 Sprite2D 节点中
- 将 3D 场景导出为 GridMap 的 MeshLibrary 资源
- 使用创建变体的选项保存场景
UID 管理（适用于 Godot 4.4+）：
- 获取特定文件的 UID
- 通过重新保存资源来更新 UID 引用

要求

您的系统上安装了Godot Engine
Node.js 和 npm
支持MCP（Cline、Cursor等）的AI助手

安装和配置

步骤 1：安装和构建

首先，克隆存储库并构建 MCP 服务器：

git clone https://github.com/Coding-Solo/godot-mcp.git
cd godot-mcp
npm install
npm run build

第 2 步：使用您的 AI 助手进行配置

选项 A：使用 Cline 配置

添加到您的 Cline MCP 设置文件（ ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json ）：

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"                  // Optional: Enable detailed logging
      },
      "disabled": false,
      "autoApprove": [
        "launch_editor",
        "run_project",
        "get_debug_output",
        "stop_project",
        "get_godot_version",
        "list_projects",
        "get_project_info",
        "create_scene",
        "add_node",
        "load_sprite",
        "export_mesh_library",
        "save_scene",
        "get_uid",
        "update_project_uids"
      ]
    }
  }
}

选项 B：使用光标配置

使用光标 UI：

前往**“光标设置”** > “功能” > “MCP”
点击**+ 添加新的 MCP 服务器**按钮
填写表格：
- 名称： godot （或您喜欢的任何名称）
- 类型： command
- 命令： node /absolute/path/to/godot-mcp/build/index.js
点击“添加”
您可能需要按 MCP 服务器卡右上角的刷新按钮来填充工具列表

使用项目特定配置：

在项目目录中创建一个文件.cursor/mcp.json ，内容如下：

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "DEBUG": "true"                  // Enable detailed logging
      }
    }
  }
}

步骤3：可选环境变量

您可以使用以下环境变量自定义服务器行为：

GODOT_PATH ：Godot 可执行文件的路径（覆盖自动检测）
DEBUG ：设置为“true”以启用详细的服务器端调试日志记录

示例提示

配置完成后，你的 AI 助手将在需要时自动运行 MCP 服务器。你可以使用以下提示：

"Launch the Godot editor for my project at /path/to/project"

"Run my Godot project and show me any errors"

"Get information about my Godot project structure"

"Analyze my Godot project structure and suggest improvements"

"Help me debug this error in my Godot project: [paste error]"

"Write a GDScript for a character controller with double jump and wall sliding"

"Create a new scene with a Player node in my Godot project"

"Add a Sprite2D node to my player scene and load the character texture"

"Export my 3D models as a MeshLibrary for use with GridMap"

"Create a UI scene with buttons and labels for my game's main menu"

"Get the UID for a specific script file in my Godot 4.4 project"

"Update UID references in my Godot project after upgrading to 4.4"

实现细节

建筑学

Godot MCP 服务器使用捆绑的 GDScript 方法执行复杂操作：

直接命令：启动编辑器或获取项目信息等简单操作直接使用 Godot 的内置 CLI 命令。
捆绑操作脚本：创建场景或添加节点等复杂操作使用单个、全面的 GDScript 文件（ godot_operations.gd ）来处理所有操作。

这种架构有以下几个好处：

无临时文件：无需临时脚本文件，保持系统清洁
简化的代码库：将所有 Godot 操作集中在一个（某种程度上）有组织的文件中
更好的可维护性：更容易添加新操作或修改现有操作
改进的错误处理：为所有操作提供一致的错误报告
减少开销：最小化文件 I/O 操作以获得更好的性能

捆绑脚本接受操作类型和参数作为 JSON，允许灵活、动态地执行操作，而无需为每个操作生成临时文件。

故障排除

Godot Not Found ：将 GODOT_PATH 环境变量设置为你的 Godot 可执行文件
连接问题：确保服务器正在运行并重新启动你的AI助手
无效的项目路径：确保路径指向包含 project.godot 文件的目录
构建问题：确保通过运行npm install安装了所有依赖项
对于光标具体来说：
确保 MCP 服务器显示并在 Cursor 设置（设置 > MCP）中启用
MCP 工具只能使用 Agent 聊天配置文件（Cursor Pro 或 Business 订阅）运行
使用“Yolo 模式”自动运行 MCP 工具请求

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。

Available Tools

14 tools

add_nodeC

Add a node to an existing scene

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory
`scenePath`	Yes	Path to the scene file (relative to project)
`parentNodePath`	No	Path to the parent node (e.g., "root" or "root/Player")	root
`nodeType`	Yes	Type of node to add (e.g., Sprite2D, CollisionShape2D)
`nodeName`	Yes	Name for the new node
`properties`	No	Optional properties to set on the node

create_sceneC

Create a new Godot scene file

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory
`scenePath`	Yes	Path where the scene file will be saved (relative to project)
`rootNodeType`	No	Type of the root node (e.g., Node2D, Node3D)	Node2D

export_mesh_libraryB

Export a scene as a MeshLibrary resource

Name	Required	Description
`projectPath`	Yes	Path to the Godot project directory
`scenePath`	Yes	Path to the scene file (.tscn) to export
`outputPath`	Yes	Path where the mesh library (.res) will be saved
`meshItemNames`	No	Optional: Names of specific mesh items to include (defaults to all)

get_debug_outputB

Get the current debug output and errors

Name	Required	Description	Default
No parameters

get_godot_versionA

Get the installed Godot version

Name	Required	Description	Default
No parameters

get_project_infoB

Retrieve metadata about a Godot project

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory

get_uidB

Get the UID for a specific file in a Godot project (for Godot 4.4+)

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory
`filePath`	Yes	Path to the file (relative to project) for which to get the UID

launch_editorC

Launch Godot editor for a specific project

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory

list_projectsA

List Godot projects in a directory

Name	Required	Description	Default
`directory`	Yes	Directory to search for Godot projects
`recursive`	No	Whether to search recursively (default: false)

load_spriteC

Load a sprite into a Sprite2D node

Name	Required	Description
`projectPath`	Yes	Path to the Godot project directory
`scenePath`	Yes	Path to the scene file (relative to project)
`nodePath`	Yes	Path to the Sprite2D node (e.g., "root/Player/Sprite2D")
`texturePath`	Yes	Path to the texture file (relative to project)

run_projectC

Run the Godot project and capture output

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory
`scene`	No	Optional: Specific scene to run

save_sceneC

Save changes to a scene file

Name	Required	Description
`projectPath`	Yes	Path to the Godot project directory
`scenePath`	Yes	Path to the scene file (relative to project)
`newPath`	No	Optional: New path to save the scene to (for creating variants)

stop_projectA

Stop the currently running Godot project

Name	Required	Description	Default
No parameters

update_project_uidsB

Update UID references in a Godot project by resaving resources (for Godot 4.4+)

Name	Required	Description	Default
`projectPath`	Yes	Path to the Godot project directory

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

14 tool updatesAug 15, 2025
- First observedadd_node
- First observedcreate_scene
- First observedexport_mesh_library
- First observedget_debug_output
- First observedget_godot_version
- First observedget_project_info
- First observedget_uid
- First observedlaunch_editor
- First observedlist_projects
- First observedload_sprite
- First observedrun_project
- First observedsave_scene
- First observedstop_project
- First observedupdate_project_uids

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

B3.4/5.0

Scored 2026-04-18 11:10 across 14 tools

Disambiguation4/5

Most tools have distinct purposes targeting different aspects of Godot project management (scene operations, project info, editor control, debugging). However, 'add_node' and 'load_sprite' could potentially overlap in functionality since loading a sprite might involve adding a node, but their descriptions clarify different specific actions.

Naming Consistency5/5

All tools follow a consistent verb_noun naming pattern (e.g., 'add_node', 'create_scene', 'get_debug_output'). The naming is uniform throughout with no mixing of conventions, making it easy to predict tool functions from their names.

Tool Count5/5

With 14 tools, this is well-scoped for a Godot MCP server covering project management, scene editing, debugging, and execution. Each tool appears to serve a specific, necessary function without obvious redundancy or bloat.

Completeness4/5

The tool set provides comprehensive coverage for core Godot workflows including project listing, scene creation/editing, debugging, and running projects. Minor gaps might include more advanced scene manipulation tools or resource management beyond UIDs, but the essentials are well-covered for typical agent tasks.

Maintenance

ActivityInactive

ResponsivenessMostly unanswered

Resources

Related MCP Connectors

hithereiamaliff-mcp-nextcloud
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Cloud Storage File Systems Workplace & Productivity
238
https://server.smithery.ai/@hithereiamaliff/mcp-nextcloud/mcp
ChiR24-unreal_mcp_server
ai.smithery
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
Developer Tools App Automation Software Architecture
21,026
https://server.smithery.ai/@ChiR24/unreal_mcp_server/mcp
mcpC
com.wix
A Model Context Protocol server for Wix AI tools
Developer Tools Content Management Systems App Automation
215
https://mcp.wix.com/mcp
AI Game Developer: MCP for Unity, Unreal and GodotA
io.github.IvanMurzak
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
App Automation Developer Tools Games & Gamification
314,598
https://ai-game.dev/mcp

Related MCP Servers

Godot MCP Enhanced
Developer Tools Games & Gamification
xinyuzjj
A
license
B
quality
D
maintenance
An enhanced MCP server for interacting with the Godot game engine, enabling AI assistants to launch the editor, run projects, manage scenes and nodes, and handle scripts.
Updated 6 months ago (2026-05-19 05:37 UTC)
16
MIT
Godot MCP server
Games & Gamification Developer Tools
fernforestgames
A
license
Not graded
quality
F
maintenance
A Model Context Protocol server that provides AI assistants with tools to interact with Godot projects, enabling starting, stopping, capturing output, and screenshots.
Updated 10 months ago (2026-01-01 16:26 UTC)
11 npm
3
MIT
Godot MCP
Developer Tools Command Line File Systems
bradypp
A
license
B
quality
D
maintenance
A Model Context Protocol server that enables AI assistants to manage Godot projects, scenes, and editor operations through natural language commands.
Updated a year ago (2025-05-31 15:05 UTC)
16
180 npm
90
MIT
Godot MCP Server
Developer Tools Code Analysis
Rizzpect
A
license
D
quality
D
maintenance
A Model Context Protocol server that enables AI assistants to manage and interact with Godot Engine projects, including project management, script editing, scene manipulation, asset management, and export.
Updated 5 months ago (2026-05-31 18:15 UTC)
46
849 npm
1
MIT

Godot MCP

介绍

特征

要求

安装和配置

步骤 1：安装和构建

第 2 步：使用您的 AI 助手进行配置

选项 A：使用 Cline 配置

选项 B：使用光标配置

步骤3：可选环境变量

示例提示

实现细节

建筑学

故障排除

执照

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Godot MCP Enhanced

Godot MCP server

Godot MCP

Godot MCP Server

Appeared in Searches