MCP.Market

Godot MCP server

by sterion66·io.github.sterion66/godot·v1.0.2·1 stars

The most complete Godot 4 MCP: secure sandbox, 40+ tools (projects–runtime), major MCP clients.

B82/100grade B
What users say
No reviews yet
Be the first
Safety scan
B82/100

full report

Adoption
New

1 stars

Reviews

Write one

Nobody has reviewed Godot yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Godot tools (40, 8 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • godot_browse_github

    Search for Godot-related repositories on GitHub.

  • godot_check_version

    Check the Godot version.

  • godot_create_code_templatewrite action

    Create code from a template.

  • godot_create_projectwrite action

    Create a Godot project under the MCP workspace: writes project.godot and a starter .tscn (what the Project Manager also creates on disk). When run_godot_import is true and GODOT_MCP_ALLOW_GODOT_EXEC=1, runs the Godot editor in headless import mode (--import) so the .godot/ cache folder exists and resources are processed—this is the engine's own initialization step; there is no separate "create pro

  • godot_create_resourcewrite action

    Create a new resource file.

  • godot_create_scenewrite action

    Create a new scene file.

  • godot_create_scriptwrite action

    Create a new GDScript file.

  • godot_download_asset

    Download an asset from the Asset Library.

  • godot_edit_file

    Edit a Godot file by replacing content.

  • godot_execute_scriptwrite action

    Execute a GDScript in the Godot project context.

  • godot_find_assets

    Find assets by extension.

  • godot_find_by_pattern

    Find files matching a pattern.

  • godot_find_godot_executable

    Find the Godot executable on the system.

  • godot_find_project

    Find the Godot project root by searching for project.godot.

  • godot_find_unused_files

    Find files that may not be referenced in scenes or scripts.

  • godot_generate_uid

    Generate a unique ID for Godot resources.

  • godot_get_asset_info

    Get detailed information about an asset.

  • godot_get_file_info

    Get information about a file.

  • godot_get_log

    Get recent Godot log entries.

  • godot_get_node_info

    Get information about a Godot node type.

  • godot_get_project_files

    Get all files in the project.

  • godot_get_project_info

    Get detailed information about the Godot project.

  • godot_get_project_settings

    Get project settings from project.godot (read-only).

  • godot_get_workspace

    Return the sandbox directory for this server.

  • godot_list_autoload

    List autoload singletons.

  • godot_list_editor_plugins

    List addon folders with plugin.cfg and which editor plugins are enabled in project.godot.

  • godot_list_projects

    List every Godot project under the MCP sandbox directory.

  • godot_list_resources

    List all .tres resource files in the Godot project.

  • godot_list_scenes

    List all .tscn scene files in the Godot project.

  • godot_list_scripts

    List all .gd script files in the Godot project.

  • godot_read_scene

    Read and parse a scene file.

  • godot_read_script

    Read and parse a GDScript file.

  • godot_refresh_project

    Refresh project cache after file changes.

  • godot_run_gamewrite action

    Run the Godot game.

  • godot_search_assetlib

    Search the official Godot Asset Library.

  • godot_search_content

    Search for content in Godot files.

  • godot_validate_scene

    Validate a scene file.

  • godot_validate_script

    Validate a GDScript file.

  • godot_watch_files

    List scene, script, and/or resource files in the project (for monitoring or refresh).

  • godot_write_filewrite action

    Write content to a file.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 150 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 82/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Godot compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
82/100
higher than 63% of 48,255 servers
Tools
40
the typical server has 7
Tools that change things
20%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
1
more than 65% of 28,688 servers

What its tools let an agent do: 32 read · 8 change

Install Godot in Claude Code, Cursor or VS Code

claude mcp add godot -- uvx godot-mcp-server
Add to Cursor

What the publisher says

From the Godot repository's README, as published. We do not edit it. Read it on GitHub

Godot MCP Server

A comprehensive FastMCP server for Godot 4.x game development. Provides tooling for AI-assisted workflows: project management, file operations, asset discovery, GDScript development, and optional Godot execution.

<!-- mcp-name: io.github.sterion66/godot -->

Contributing · Security

Security model: All Godot projects, file writes, and Asset Library downloads are restricted to a single workspace directory on your machine (default ~/godot-games). The server refuses paths outside that tree. See Workspace setup.

Code execution: godotrungame and godotexecutescript require GODOTMCPALLOWGODOTEXEC in the server environment. The shipped MCP JSON configs set it to 1 so these tools work after copy-paste. Running python godotmcpserver.py without that env still leaves execution off until you export it. To lock down an IDE install, remove the variable or set it to 0. See Godot execution (environment).

HTTP transport: Binding to 0.0.0.0 or :: exposes the MCP server on all network interfaces; prefer 127.0.0.1 unless you use a firewall or VPN.

Symlinks: GODOTMCPROOT is resolved with symlinks followed; point it at a real directory you control.

Features

Project Management

  • Auto-detect Godot projects (project.godot); list all projects under the workspace (godotlistprojects)
  • Create new projects under the workspace (godotcreateproject)
  • Parse project settings and configuration; list autoloads and editor plugin state (read-only for plugins)
  • Refresh project cache after changes

File Operations

  • Read/write scenes (.tscn), scripts (.gd), resources (.tres)
  • Create new scripts, scenes, resources from templates
  • Edit existing files with content replacement
  • Validate scene and script syntax

Code Generation

  • CharacterBody2D/3D movement controllers
  • State machine patterns
  • Custom resources
  • Node scripts with signals/exports

Asset Management

  • Discover assets by extension, pattern, glob
  • Find unused assets
  • Search file contents with regex
  • Search & download from Godot Asset Library
  • Browse Godot repos on GitHub

Runtime Integration

  • Find Godot executable
  • Check Godot version
  • Run game headless
  • Execute GDScript code
  • Read Godot logs
  • File watcher configuration

Installation

# From PyPI-style editable install (recommended for contributors)
pip install -e .

# Or minimal deps only
pip install -r requirements.txt

Console entry point (after pip install -e .): godot-mcp-server (same as python godotmcpserver.py).

Workspace setup (required)

The MCP server only operates on Godot projects that live under one root folder. This keeps assistants from reading or writing arbitrary paths on your system.

  1. Create the default folder (once per machine):
mkdir -p ~/godot-games
  1. Put every Godot game there — each game is its own subdirectory containing project.godot, for example:
~/godot-games/
     my-platformer/     ← open this folder in your editor
       project.godot
       ...
     another-game/
       project.godot
  1. Open your IDE workspace inside ~/godot-games/.../your-game (or a parent folder under ~/godot-games) so the MCP process can discover project.godot from the current working directory.
  1. Custom location: Set an absolute path before starting the server:

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Godot: common questions

Is Godot MCP server safe?
Mostly: it is graded B (82/100). Read the Godot safety report
How do I install Godot?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Godot need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Godot maintained?
The last commit was 187 days ago (2026-05-01). The latest release is v1.0.2.
How does Godot compare with other MCP servers?
safety score 82/100 (higher than 63% of 48,255 servers); tools 40 (the typical server has 7); tools that change things 20% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.