gopeak — Claude Code MCP server: features and setup
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+.
claude mcp add gopeak -- npx -y gopeakWhat gopeak 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.
What it helps with
- find Godot projects and inspect project details
- create
scenes/Player.tscnwith aCharacterBody2Droot - run a game and retrieve debug output
- trace the top error in the log and fix it
Example prompts for the agent
- Find Godot projects in
/your/projectsand show their project details. - Create
scenes/Player.tscnwith aCharacterBody2Droot and add a movement script. - Run the project, retrieve debug output, then fix the top error.
How to install gopeak
Platform CLI
claude mcp add gopeak -- npx -y gopeakPlatform CLI
codex mcp add gopeak -- npx -y gopeakConfig file
{
"mcpServers": {
"gopeak": {
"command": "npx",
"args": [
"-y",
"gopeak"
]
}
}
}Config file
{
"servers": {
"gopeak": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gopeak"
]
}
}
}Platform CLI
gemini mcp add gopeak npx -y gopeakStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about gopeak
How do I install gopeak in Claude Code?
Run claude mcp add gopeak -- npx -y gopeak. Godot 4.x and Node.js 18+ are required.
What does gopeak do?
It connects an AI assistant to Godot projects for running games, inspecting project state, and debugging. Its tools also cover scenes and scripts.
What is required for live scene inspection?
The runtime tool group requires a runtime addon or socket. In compact mode, extra tool groups activate as needed.
