Log inSubmit server
Godot Forge logo

Godot Forge

by gregario

Godot 4 MCP tools for tests, API lookup, GDScript analysis, scene parsing, diagnostics, project control, and screenshots.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Godot Forge

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "gregario-godot-forge": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 8 tools correctly (1mo ago).

Overview

gregario/godot-forge MCP server gives AI coding assistants eight tools for inspecting and operating Godot 4 projects. It can run GUT or GdUnit4 tests, search Godot 4 API documentation with Godot 3-to-4 migration guidance, analyze scripts and scenes, and report project structure. Godot-dependent tools can launch projects, capture debug output, retrieve editor diagnostics, or return viewport screenshots. Reach for it when an MCP-compatible IDE needs structured feedback during Godot development; six tools work without Godot installed, while testing, project launching, and screenshots require the Godot binary.

Use cases

  • Run GUT or GdUnit4 tests from an AI coding assistant
  • Find Godot 4 replacements for deprecated Godot 3 APIs
  • Analyze GDScript and scene files for common project issues
  • Inspect project diagnostics and debug output
  • Capture a running game viewport for review

Key features

  • Headless GUT and GdUnit4 test execution
  • Godot 4 API search with 3-to-4 migration mappings
  • GDScript pitfall and scene resource analysis
  • Godot LSP diagnostics retrieval
  • Project launch, debug output, and screenshot capture
  • Progressive project structure inspection

Tools8

What Godot Forge lets your agent do. Expand a tool for its parameters.

Verified live~976 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/19 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · godot-forge (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars9Stargazers on the source repository.
npm downloads254Package downloads in the last 30 days.
Last commit6mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed8Callable tools this server registers over MCP.
Directory activity8 viewsConfig copies, upvotes, and views on AllMCPs.

How Godot Forge works

What gregario/godot-forge MCP server does

gregario/godot-forge MCP server connects an MCP-compatible coding assistant to common Godot 4 development tasks. It exposes eight focused tools rather than a general-purpose wrapper around every Godot operation.

The tools cover automated testing, API documentation lookup, static analysis, scene and resource inspection, project inventory, language-server diagnostics, project execution, and screenshot capture. Results are returned in structured form where applicable, including test counts, failure locations, diagnostic messages, project metadata, and base64-encoded PNG screenshots.

How it works

The server communicates with the assistant through MCP and locates a Godot project by searching upward from the current directory for project.godot. It also searches for the Godot executable automatically. The lookup order starts with GODOT_PATH, then checks godot or godot4 on PATH, followed by common Steam and platform-specific installation locations.

Godot is not needed for documentation search, script analysis, scene analysis, or project information. Running tests, starting or stopping a project, and taking screenshots use the Godot binary. Language-server diagnostics have a different requirement: the Godot editor must be open with the project loaded.

Test execution detects either GUT or GdUnit4 and can return pass/fail totals plus failure file paths and line numbers. Documentation search handles Godot 4.x queries and can identify older Godot 3 terms, returning suggested Godot 4 equivalents. Project information uses progressive disclosure, providing a summary first and more detail when requested.

Setup and configuration

Install the gregario/godot-forge MCP server with Node.js 18 or newer:

Terminal
npx -y godot-forge

Add that command to the MCP configuration for a supported client such as Claude Desktop, Cursor, Windsurf, or Cline. The repository also documents setup for other IDEs.

The project directory is detected automatically. To select a project explicitly, pass its directory with the server's --project option. Set GODOT_PATH when the automatic executable search does not find the intended Godot binary. Godot 4.x is optional for the tools that only inspect files or documentation, but is needed for execution-related operations.

Tools and capabilities

  • godot_run_tests runs GUT or GdUnit4 headlessly, with optional filtering by script, method, or inner class.
  • godot_search_docs searches Godot 4 API references and supplies migration mappings for deprecated Godot 3 APIs.
  • godot_analyze_script checks ten documented GDScript pitfalls, including outdated APIs, oversized scripts, unsafe type inference, coupling, signal issues, autoload problems, and Python-style syntax.
  • godot_analyze_scene parses .tscn and .tres files, checking nesting, node count, missing scripts, and resource-format problems.
  • godot_get_project_info reports the project name, Godot version, scenes, scripts, autoloads, addons, and directory tree.
  • godot_get_diagnostics reads errors and warnings from Godot's built-in language server when the editor is running.
  • godot_run_project launches or stops a project and captures timestamped standard output and error output.
  • godot_screenshot captures the running viewport as a base64 PNG and requires a display server rather than headless mode.

Limitations and notes

gregario/godot-forge MCP server is aimed at Godot 4 workflows. Its migration lookup can suggest replacements for Godot 3 APIs, but that does not make it a Godot 3 tool. Screenshot capture requires a graphical display, and language-server results are unavailable unless the editor has the project open.

The repository describes the package as cross-platform for macOS, Windows, and Linux, including both Steam and non-Steam Godot installations. The source is licensed under MIT. Planned roadmap items such as input simulation, runtime scene-tree inspection, profiling, shader validation, and export or CI support are not listed as current tools.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Godot Forge

Run `npx -y godot-forge` with Node.js 18 or newer, then add the command to your MCP client configuration.

Yes. The repository provides a Claude Desktop configuration using `npx -y godot-forge`.

Only six of the eight tools work without Godot. Test execution, project launching, and screenshots require a Godot binary.

Set the `GODOT_PATH` environment variable to the Godot binary path. The server otherwise checks common executable names and installation locations.

The Godot editor must be running with the project open for `godot_get_diagnostics` to return LSP diagnostics.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGodot Forge AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/gregario-godot-forge?style=directory)](https://allmcps.com/mcp/gregario-godot-forge)
HTML Embed
<a href="https://allmcps.com/mcp/gregario-godot-forge"><img src="https://allmcps.com/api/badge/gregario-godot-forge?style=directory" alt="Godot Forge on AllMCPs" /></a>