godette-mcp

MCP server for Godot game development. Provides 45 tools for reading, analyzing, and editing Godot projects through the Model Context Protocol.

• Scene tools — traverse scene trees, find nodes by type/group/script, trace signal chains, query dependencies
• Scene editing — add/remove nodes, connect/disconnect signals, manage groups, modify properties
• Symbol tools — find and navigate GDScript symbols with LSP when available, regex parser as fallback
• Symbol editing — replace function bodies, insert before/after symbols with hash-verified safety
• Resource tools — find resources by type, inspect properties, trace cross-project references
• File tools — Godot-enriched file reads (parsed symbols for .gd, scene structure for .tscn)
• Runtime tools — run/stop scenes, capture game state, take screenshots, read console output (requires editor plugin)
• Memory tools — persistent key-value memory for project context across sessions

• Node.js >= 20
• A Godot 4.x project
• (Optional) Godot editor running for LSP support
• (Optional) GDScript editor plugin for runtime tools

npm install godette

Or run directly:

npx godette

Add to your MCP client configuration (e.g. Claude Desktop):

{
  "mcpServers": {
    "godette": {
      "command": "npx",
      "args": ["godette"],
      "env": {
        "GODOT_PROJECT": "/path/to/your/godot/project"
      }
    }
  }
}

The server auto-detects the Godot project root from the working directory or GODOT_PROJECT env var.

import { parseTscn, parseGdScript, UnifiedIndex, EventBus } from "godette";

// Parse a scene file
const scene = parseTscn(tscnSource, "/path/to/scene.tscn");
console.log(scene.rootType, scene.nodes.size);

// Parse a GDScript file
const scrip