# gopeak

gopeak connects an AI assistant to Godot projects so it can run games, inspect project state, and help debug errors. It requires Godot 4.x and Node.js 18+.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 269
- Author: HaD0Yun
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/HaD0Yun/Doyunha-Gopeak
- Updated: 2026-09-12
- HTML: https://affpapa.org/en/nevibecode/mcp/gopeak

## What it does

gopeak gives an assistant tools for finding Godot projects, editing scenes and scripts, inspecting resources, and running a game. The assistant can read debug output and use it to address an error. The server also integrates with LSP and DAP.

In `compact` mode, extra tool groups activate as needed; `full` exposes the complete legacy tool list for compatibility and audits. Some capabilities depend on the editor, LSP, DAP, or a runtime addon. For example, inspecting a live scene requires a runtime addon or socket, so that workflow depends on project setup.

You need Godot 4.x and Node.js 18+. Start the server with `npx -y gopeak`, then add it to your MCP client configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Works with: Godot

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add gopeak -- npx -y gopeak
```

### Codex

**Platform CLI**
```bash
codex mcp add gopeak -- npx -y gopeak
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gopeak": {
            "command": "npx",
            "args": [
                "-y",
                "gopeak"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gopeak": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "gopeak"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add gopeak npx -y gopeak
```

## When to use it
- find Godot projects and inspect project details
- create `scenes/Player.tscn` with a `CharacterBody2D` root
- run a game and retrieve debug output
- trace the top error in the log and fix it

## Example prompts
- Find Godot projects in `/your/projects` and show their project details.
- Create `scenes/Player.tscn` with a `CharacterBody2D` root and add a movement script.
- Run the project, retrieve debug output, then fix the top error.

## Similar
- [Pascal 3D Editor](https://affpapa.org/en/nevibecode/mcp/pascal-3d-editor.md) — MCP server · ★ 25085
- [Unity-MCP](https://affpapa.org/en/nevibecode/mcp/unity-mcp.md) — MCP server · ★ 4523
- [mcp](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — MCP server · ★ 1348
- [Gearboy MCP Server](https://affpapa.org/en/nevibecode/mcp/gearboy-mcp-server.md) — MCP server · ★ 1219
- [ChiR24-unreal_mcp_server](https://affpapa.org/en/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP server · ★ 975
- [Nova3D](https://affpapa.org/en/nevibecode/mcp/nova3d.md) — MCP server · ★ 733

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md