Gopeak-godot-mcp

概述

GoPeak 让 AI 助手能够通过编辑 → 运行 → 检查 → 修复的循环与 Godot 4 进行交互。它提供场景管理、GDScript 编辑、调试、运行时检查和资源工作流等工具。服务器提供三种工具配置文件：'compact'（默认，最小化工具配合可选组）、'full'（完整遗留接口）和 'legacy'（与 full 相同）。某些可选功能需要额外的 Godot 插件和服务，如 LSP 和 DAP 服务器。

试试问 AI

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

• tool.catalog

  Search and activate capability groups based on keywords.

  试试:Find animation tools试试:Show me all debugging tools
• tool.groups

  Manage tool capability groups directly.

  试试:Activate the runtime group试试:List available groups
• get_editor_status

  Check the status of the Godot editor bridge connection.

  试试:Is the editor connected?试试:Show bridge status
• find_projects

  Find Godot projects in specified directories.

  试试:List projects in /my/godot试试:Find all Godot projects
• launch_editor

  Launch the Godot editor with project context.

  试试:Open the Player scene in Godot试试:Launch editor with my project
• run_project

  Run the Godot project and collect output.

  试试:Start the game试试:Run my project and capture logs
• stop_project

  Stop a running Godot project.

  试试:Stop the game试试:Terminate running project
• add_node

  Add a node to the current scene.

  试试:Add a CharacterBody2D to the scene试试:Create a new Sprite node
• set_node_properties

  Set properties of a node in the scene.

  试试:Set the player position to 100, 200试试:Change node scale to 2, 2
• create_scene

  Create a new Godot scene file.

  试试:Create scenes/Player.tscn试试:Make a new scene with root Node2D
• create_gdscript

  Create or modify GDScript files.

  试试:Create a movement script for Player试试:Update the attack function
• screenshot

  Capture a screenshot of the running game.

  试试:Take a screenshot of the current game view试试:Capture the main viewport

可对比工具

安装

npx -y gopeak

{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "gopeak"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "GOPEAK_TOOL_PROFILE": "compact"
      }
    }
  }
}

curl -sL https://raw.githubusercontent.com/HaD0Yun/Gopeak-godot-mcp/main/install-addon.sh | bash

FAQ

哪些 MCP 客户端与 GoPeak 兼容？

GoPeak 与 Claude Desktop、Cursor、Cline 和 OpenCode 等 MCP 客户端兼容。

GoPeak 提供哪些可选功能？

GoPeak 提供可选功能包括运行时检查、截图、输入注入（需要运行时插件）、GDScript LSP 工具（需要端口 6005 上的 Godot LSP）、DAP 调试工具（需要端口 6006 上的 Godot DAP）和资产商店工具（需要网络访问）。

如果 GoPeak 工具不可见，如何排查？

重新启动您的 MCP 客户端，使用 'tool.catalog' 搜索隐藏的工具，使用 'tool.groups' 激活工具组，确认项目路径有效，或确保运行时工具已正确安装和启用。

Gopeak-godot-mcp 对比