godot-mcp

概述

Godot MCP 是一个全面的模型上下文协议服务器，使 AI 助手能够完全控制 Godot 游戏引擎。它包含 149 个工具，涵盖网络、3D/2D 渲染、UI 控制、音频效果、动画树、文件 I/O、运行时代码执行、属性检查、场景操作、信号管理、物理、项目创建等功能。该服务器基于原始 godot-mcp 项目构建并扩展，工具数量从 20 个大幅增加到 149 个，包括运行时代码执行、节点检查、动画控制和无头场景操作等重要增强功能。

试试问 AI

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

• game_eval

  Execute arbitrary GDScript code in the running game with return values

  试试:Execute this GDScript code and return the result试试:Run the following async code in the game engine试试:Evaluate this script expression and show the output
• game_get_property

  Read any property on any node by path in the running game

  试试:Get the position property of the player node试试:Read the health value from the enemy character试试:Show the current scene's background color
• game_set_property

  Write any property on any node by path in the running game

  试试:Set the player's position to coordinates (100, 50)试试:Change the enemy's health to zero试试:Update the main scene's background to blue
• game_call_method

  Call any method on any node with arguments in the running game

  试试:Call the jump method on the player node试试:Trigger the attack function with damage value 50试试:Run the spawn_enemy method with position (200, 300)
• game_instantiate_scene

  Dynamically add scenes to the running game

  试试:Instantiate the bullet scene at the player's position试试:Add a new enemy to the scene试试:Load and display the explosion effect
• game_play_animation

  Control AnimationPlayer in the running game

  试试:Play the idle animation on the character试试:Pause the current animation sequence试试:List all available animations in the AnimationPlayer
• game_pause

  Pause or unpause the running game

  试试:Pause the game试试:Unpause the game试试:Toggle the game's paused state
• read_scene

  Parse any .tscn file and get full node tree with properties as JSON

  试试:Show me the structure of the main scene file试试:List all nodes in the level scene试试:Get the properties of the enemy node in level.tscn
• create_project

  Create a new Godot project from scratch

  试试:Create a new 2D game project named 'MyGame'试试:Initialize a Godot project with 3D settings试试:Set up a new project at path /projects/NewGame
• manage_export_presets

  Create or modify export preset configuration

  试试:Create a Windows export preset试试:Modify the Android build settings试试:List all available export presets
• game_http_request

  Make HTTP GET/POST/PUT/DELETE requests with headers and body

  试试:Send a GET request to https://api.example.com/data试试:Post JSON data to the server endpoint试试:Fetch the latest game assets from the CDN
• game_ui_control

  Set focus, anchors, tooltip, mouse filter on UI controls

  试试:Set the main button as focused试试:Change the anchor preset for the inventory panel试试:Set tooltip text for the help button

可对比工具

安装

npm install godot-mcp

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/path/to/godot-mcp/dist/index.js"],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

FAQ

这是否需要运行中的 Godot 实例？

不需要。许多工具可以在无头模式下运行，不需要正在运行的游戏，但运行时功能需要活动的游戏实例。

它支持哪些编程语言？

服务器本身使用 JavaScript/TypeScript 编写。它与 Godot 的 GDScript 语言交互处理游戏逻辑。

godot-mcp 对比