GoPeak Godot Engine

v1.0.0Developer Toolsstable

GoPeak — The most comprehensive MCP server for Godot Engine. 95+ tools: scene management, GDScript LSP, DAP debugger, screenshot capture, input injection, ClassDB introspection, CC0 asset library. npx gopeak

aiai-integrationai-toolsclaudecursor
Share:
188
Stars
0
Downloads
0
Weekly
0/5

What is GoPeak Godot Engine?

GoPeak Godot Engine is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to gopeak — the most comprehensive mcp server for godot engine. 95+ tools: scene management, gdscript lsp, dap debugger, screenshot capture, input injection, classdb introspection, cc0 asset library. npx...

GoPeak — The most comprehensive MCP server for Godot Engine. 95+ tools: scene management, GDScript LSP, DAP debugger, screenshot capture, input injection, ClassDB introspection, CC0 asset library. npx gopeak

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • GoPeak — The most comprehensive MCP server for Godot Engine.

Use Cases

95+ tools for Godot development
Scene management and debugging
CC0 asset library integration
HaD0Yun

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx doyunha-gopeak

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use GoPeak Godot Engine

GoPeak is the most comprehensive MCP server for Godot Engine, exposing 95+ tools that let AI agents control nearly every aspect of game development: scene and script creation, GDScript Language Server Protocol diagnostics, Debug Adapter Protocol breakpoints, runtime screenshot capture, input injection, ClassDB introspection, and a CC0 asset library. Instead of manually tweaking nodes or hunting documentation, developers can describe what they want in natural language and have Claude or Cursor write GDScript, create scenes, run the game, read debug output, and fix errors in a fully automated loop.

Prerequisites

  • Godot Engine 4.x installed with the executable accessible on your system
  • Node.js 18 or newer with npx available
  • Claude Desktop, Cursor, or another MCP-capable client
  • Optional: Godot editor plugins (godot_mcp_editor, godot_mcp_runtime) for scene/resource bridge and runtime inspection features
1

Install and run GoPeak via npx

GoPeak is distributed as an npm package. Run it with npx — no global install needed. Set GODOT_PATH if the Godot binary is not on your system PATH.

npx -y gopeak
2

Set the GODOT_PATH environment variable if needed

If Godot is not auto-detected, provide the full path to the Godot executable. On macOS this is typically inside the .app bundle.

# macOS example
export GODOT_PATH="/Applications/Godot.app/Contents/MacOS/Godot"
# Linux example
export GODOT_PATH="/usr/local/bin/godot4"
3

Install optional Godot editor plugins for full tool coverage

Scene/resource editing and runtime inspection tools require two Godot plugins. Run the installer script, then enable both plugins in Project Settings > Plugins inside Godot.

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

Add GoPeak to your MCP client configuration

Edit your claude_desktop_config.json or Cursor MCP settings to launch GoPeak as an MCP server with environment variables for your Godot path and desired tool profile.

{
  "mcpServers": {
    "gopeak": {
      "command": "npx",
      "args": ["-y", "gopeak"],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot",
        "GOPEAK_TOOL_PROFILE": "compact"
      }
    }
  }
}
5

Restart your MCP client and open a Godot project

Restart Claude Desktop or Cursor. Open a Godot project in the editor. GoPeak communicates with the running Godot editor over the bridge port (default 6505).

6

Discover available tool groups

Use the tool.catalog command to see all 95+ tools organized by group, then activate specific groups as needed for your task.

GoPeak Godot Engine Examples

Client configuration

Claude Desktop configuration for GoPeak with compact tool profile and explicit Godot path on macOS.

{
  "mcpServers": {
    "gopeak": {
      "command": "npx",
      "args": ["-y", "gopeak"],
      "env": {
        "GODOT_PATH": "/Applications/Godot.app/Contents/MacOS/Godot",
        "GOPEAK_TOOL_PROFILE": "compact",
        "GODOT_BRIDGE_PORT": "6505"
      }
    }
  }
}

Prompts to try

These prompts leverage GoPeak's scene management, scripting, debugging, and runtime inspection capabilities.

- "Create scenes/Player.tscn with a CharacterBody2D root and attach a movement script"
- "Run the project, read the debug output, and fix the top error"
- "Take a screenshot of the running game and describe what you see"
- "Use tool.catalog to find animation tools, then activate the right group and add an AnimationPlayer to the Player scene"
- "List all nodes in the current scene tree"
- "Search the CC0 asset library for a 2D platformer tileset and import it"

Troubleshooting GoPeak Godot Engine

GoPeak cannot find the Godot executable

Set the GODOT_PATH environment variable to the full absolute path of your Godot 4.x binary in the MCP client configuration. On macOS the path is usually /Applications/Godot.app/Contents/MacOS/Godot.

Scene and resource tools return errors about the bridge not being connected

The scene/resource bridge tools require the godot_mcp_editor plugin to be installed and enabled in your Godot project. Run the install-addon.sh script, then enable the plugin in Project Settings > Plugins inside Godot Editor.

Too many tools are causing context window issues in the AI client

Set GOPEAK_TOOL_PROFILE to 'compact' (default) instead of 'full' to expose only the most commonly needed tools. Use tool.catalog to discover and activate specific tool groups on demand rather than loading all 95+ tools at startup.

Frequently Asked Questions about GoPeak Godot Engine

What is GoPeak Godot Engine?

GoPeak Godot Engine is a Model Context Protocol (MCP) server that gopeak — the most comprehensive mcp server for godot engine. 95+ tools: scene management, gdscript lsp, dap debugger, screenshot capture, input injection, classdb introspection, cc0 asset library. npx gopeak It connects AI assistants to external tools and data sources through a standardized interface.

How do I install GoPeak Godot Engine?

Follow the installation instructions on the GoPeak Godot Engine GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with GoPeak Godot Engine?

GoPeak Godot Engine works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is GoPeak Godot Engine free to use?

Yes, GoPeak Godot Engine is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "doyunha-gopeak": { "command": "npx", "args": ["-y", "doyunha-gopeak"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use GoPeak Godot Engine?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides