Gopeak-godot-mcp

Overview

GoPeak enables AI assistants to interact with Godot 4 through an edit → run → inspect → fix loop. It provides tools for scene management, GDScript editing, debugging, runtime inspection, and asset workflows. The server offers three tool profiles: 'compact' (default, minimal tools with optional groups), 'full' (complete legacy surface), and 'legacy' (same as full). Optional capabilities require additional Godot plugins and services like LSP and DAP servers.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• tool.catalog

  Search and activate capability groups based on keywords.

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

  Manage tool capability groups directly.

  Try:Activate the runtime groupTry:List available groups
• get_editor_status

  Check the status of the Godot editor bridge connection.

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

  Find Godot projects in specified directories.

  Try:List projects in /my/godotTry:Find all Godot projects
• launch_editor

  Launch the Godot editor with project context.

  Try:Open the Player scene in GodotTry:Launch editor with my project
• run_project

  Run the Godot project and collect output.

  Try:Start the gameTry:Run my project and capture logs
• stop_project

  Stop a running Godot project.

  Try:Stop the gameTry:Terminate running project
• add_node

  Add a node to the current scene.

  Try:Add a CharacterBody2D to the sceneTry:Create a new Sprite node
• set_node_properties

  Set properties of a node in the scene.

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

  Create a new Godot scene file.

  Try:Create scenes/Player.tscnTry:Make a new scene with root Node2D
• create_gdscript

  Create or modify GDScript files.

  Try:Create a movement script for PlayerTry:Update the attack function
• screenshot

  Capture a screenshot of the running game.

  Try:Take a screenshot of the current game viewTry:Capture the main viewport

Comparable tools

Installation

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

Which MCP clients are compatible with GoPeak?

GoPeak is compatible with MCP clients such as Claude Desktop, Cursor, Cline, and OpenCode.

What optional capabilities does GoPeak provide?

GoPeak offers optional capabilities including runtime inspection, screenshots, input injection (requires runtime addon), GDScript LSP tools (requires Godot LSP on port 6005), DAP debugging tools (requires Godot DAP on port 6006), and asset store tools (requires network access).

How do I troubleshoot if GoPeak tools aren't visible?

Restart your MCP client, search for hidden tools using 'tool.catalog', activate a group with 'tool.groups', confirm your project path is valid, or ensure runtime tools are properly installed and enabled.

Compare Gopeak-godot-mcp with