The MCP server for Godot 4. Test runner, API docs, script analysis, and more.
Godot Forge
The MCP server for Godot 4. Test runner, API docs, script analysis, and more.AI coding assistants are structurally bad at GDScript. Models trained on data skewed towards Godot 3 hallucinate deprecated APIs (yield instead of await, KinematicBody instead of CharacterBody3D, export var instead of @export var). Godot Forge fixes this.
8 tools. Zero config. Works with every MCP-compatible IDE.
Install
npx -y godot-forge
That's it. Godot Forge auto-detects your Godot binary (Steam, Homebrew, direct download) and finds your project.godot automatically.
Add to your IDE
Claude Code
claude mcp add godot-forge -- npx -y godot-forge
Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"godot-forge": {
"command": "npx",
"args": ["-y", "godot-forge"]
}
}
}
VS Code (Copilot)
Add to .vscode/mcp.json:
{
"servers": {
"godot-forge": {
"command": "npx",
"args": ["-y", "godot-forge"]
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"godot-forge": {
"command": "npx",
"args": ["-y", "godot-forge"]
}
}
}
Zed
Add to settings.json:
{
"context_servers": {
"godot-forge": {
"command": {
"path": "npx",
"args": ["-y", "godot-forge"]
}
}
}
}
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):
{
"mcpServers": {
"godot-forge": {
"command": "npx",
"args": ["-y", "godot-forge"]
}
}
}
More IDEs (Codex, Gemini CLI, JetBrains, Continue, Cline, Roo Code, Neovim, OpenCode, Kiro)
See IDE Setup Guide for configuration snippets for all supported IDEs.
Tools
| Tool | Description | Needs Godot | Needs Editor |
|---|---|---|---|
godot_run_tests |
Run GUT/GdUnit4 tests, get structured pass/fail results | Yes | No |
godot_search_docs |
Search Godot 4 API docs with 3→4 migration mapping | No | No |
godot_analyze_script |
Detect 10 GDScript pitfalls (deprecated API, coupling, re-entrancy) | No | No |
godot_analyze_scene |
Parse .tscn/.tres, detect antipatterns and format errors | No | No |
godot_get_project_info |
Project structure overview with progressive disclosure | No | No |
godot_get_diagnostics |
LSP diagnostics from Godot's language server | No | Yes |
godot_run_project |
Launch/stop project, capture debug output | Yes | No |
godot_screenshot |
Capture viewport screenshot as base64 PNG | Yes | No |
[!TIP] 6 of 8 tools work without Godot installed. Only test running, project launching, and screenshots need the binary.
Features
Test Runner
Auto-detects GUT and GdUnit4. Returns structured JSON with pass/fail counts, failure details with file paths and line numbers. Supports filtering by script, method, or inner class.
Ask your AI: "Run the water profile tests"
→ { total: 5, passed: 5, failed: 0, duration_ms: 462 }
Godot 3→4 Migration Mapping
The #1 reason AI writes broken GDScript. When your AI queries a deprecated API, it gets the correct Godot 4 equivalent instantly (30+ mappings covering classes, methods, syntax, and constants).
Query: "KinematicBody" → "Renamed to CharacterBody3D in Godo
Tools (8)
godot_run_testsRun GUT/GdUnit4 tests, get structured pass/fail resultsgodot_search_docsSearch Godot 4 API docs with 3→4 migration mappinggodot_analyze_scriptDetect 10 GDScript pitfalls (deprecated API, coupling, re-entrancy)godot_analyze_sceneParse .tscn/.tres, detect antipatterns and format errorsgodot_get_project_infoProject structure overview with progressive disclosuregodot_get_diagnosticsLSP diagnostics from Godot's language servergodot_run_projectLaunch/stop project, capture debug outputgodot_screenshotCapture viewport screenshot as base64 PNGConfiguration
{"mcpServers": {"godot-forge": {"command": "npx", "args": ["-y", "godot-forge"]}}}