Skillget

better-godot-mcp

mcp
Security Audit
Fail
Health Warn
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Fail
  • rm -rf — Recursive force deletion command in package.json
Permissions Pass
  • Permissions — No dangerous permissions requested
Purpose
This tool is a Model Context Protocol (MCP) server designed to help AI agents interact with the Godot game engine. It provides 17 "mega-tools" that allow AI assistants to directly create, modify, and manage game scenes, scripts, and assets.

Security Assessment
The overall security risk is Medium. The server is designed to execute file operations, modifying your local file system by creating and writing game files directly. The automated scan raised a red flag by detecting a recursive force deletion command (`rm -rf`) inside the `package.json` file. While this is frequently used in build scripts to clean directories, developers should verify exactly what paths it targets to prevent accidental data loss. The tool does not request dangerous system permissions, and no hardcoded secrets were found. Because it handles local project files, network access appears minimal and limited to standard package operations.

Quality Assessment
The project demonstrates strong software engineering practices. It has a CI/CD pipeline, tracks code coverage, uses automated semantic releases, and is actively maintained (last updated today). It is legally safe to use, protected under the permissive MIT license. However, community trust is currently very low. With only 5 GitHub stars, the tool has not yet been widely adopted or battle-tested by a large audience.

Verdict
Use with caution: the project is highly active and well-structured, but the low community adoption combined with `rm -rf` scripts in the package configuration warrants a quick manual code review before integrating it into your workflow.
SUMMARY

MCP server for Godot Engine - composite tools optimized for AI agents

README.md

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Composite MCP server for Godot Engine -- 17 mega-tools for AI-assisted game development

CI
codecov
npm
Docker
License: MIT

TypeScript
Node.js
Godot Engine
semantic-release
Renovate

Better Godot MCP server

Features

  • 17 composite mega-tools -- scene, node, script, shader, animation, tilemap, physics, audio, navigation, UI, and more
  • Full scene control -- create, parse, and modify .tscn files directly without Godot running
  • GDScript CRUD -- create, read, write, and attach scripts in a single call
  • Tiered token optimization -- compressed descriptions + on-demand help tool

Quick Start

Claude Code Plugin (Recommended)

Via marketplace (includes skills: /build-scene, /debug-issue, /add-mechanic):

/plugin marketplace add n24q02m/claude-plugins
/plugin install better-godot-mcp@n24q02m-plugins

Gemini CLI Extension

gemini extensions install https://github.com/n24q02m/better-godot-mcp

Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.better-godot-mcp]
command = "npx"
args = ["-y", "@n24q02m/better-godot-mcp"]

MCP Server

Option 1: npx

{
  "mcpServers": {
    "better-godot": {
      "command": "npx",
      "args": ["-y", "@n24q02m/better-godot-mcp@latest"]
    }
  }
}

Other runners: bun x, pnpm dlx, yarn dlx also work.

Option 2: Docker

{
  "mcpServers": {
    "better-godot": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "n24q02m/better-godot-mcp:latest"
      ]
    }
  }
}

Note: Project path is passed via tool parameters (project_path), not environment variables. In Docker mode, mount your project directory.

Tools

Tool Actions Description
project info, version, run, stop, settings_get, settings_set, export Project metadata, run/stop, and settings
scenes create, list, info, delete, duplicate, set_main Scene file management
nodes add, remove, rename, list, set_property, get_property Scene tree node manipulation
scripts create, read, write, attach, list, delete GDScript file CRUD
editor launch, status Launch Godot editor and check status
config status, set, detect_godot, check Server configuration and environment detection
resources list, info, delete, import_config Resource file management
input_map list, add_action, remove_action, add_event Input action and event mapping
signals list, connect, disconnect Signal connections
animation create_player, add_animation, add_track, add_keyframe, list Animation players and tracks
tilemap create_tileset, add_source, set_tile, paint, list TileMap and TileSet management
shader create, read, write, get_params, list Shader file CRUD with Godot 4 syntax
physics layers, collision_setup, body_config, set_layer_name Collision layers and physics bodies
audio list_buses, add_bus, add_effect, create_stream Audio bus and effect management
navigation create_region, add_agent, add_obstacle Navigation regions, agents, and obstacles
ui create_control, set_theme, layout, list_controls UI control creation and theming
help - Get full documentation for any tool

Zero-Config Setup

No environment variables needed. On first start, the server opens a setup page in your browser:

  1. Start the server (via plugin, npx, or Docker)
  2. A setup URL appears -- open it in any browser
  3. Fill in your credentials on the guided form
  4. Credentials are encrypted and stored locally

Your credentials never leave your machine. The relay server only sees encrypted data.

For CI/automation, you can still use environment variables (see below).

Configuration

Variable Required Default Description
GODOT_PROJECT_PATH No - Default project path (tools also accept project_path param)
GODOT_PATH No Auto-detected Path to Godot binary

Limitations

  • Requires Godot 4.x project structure
  • Scene files (.tscn) are parsed/modified via text manipulation, not Godot's internal API
  • run/stop/export actions require Godot binary to be installed
  • Docker mode has limited filesystem access (mount your project directory)

Security

  • Binary detection -- Multi-path Godot detection (env, PATH, common locations)
  • Project validation -- Verifies project.godot exists before operations
  • Cross-platform -- Windows, macOS, Linux path handling

Build from Source

git clone https://github.com/n24q02m/better-godot-mcp.git
cd better-godot-mcp
bun install
bun run dev

License

MIT -- See LICENSE.

Reviews (0)

No results found