minimal-godot-mcp
MCP server bridging Godot's native LSP to AI coding assistants for GDScript validation
Agenten stärken
Installation vom Herausgeber. Kein PlugMCP-Endpunkt.
Host a copy with our keys and logs.
Noch kein paketiertes Release in der Registry. Folgen Sie der README des Repositorys.
Remote-URL oder ein Befehl auf Ihrem Rechner? Worin sich die beiden Installationen unterscheiden
Auf PlugMCP ausführen
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
StartenPrerequisites: Node.js 22+, Godot 3.2+ or 4.x with LSP enabled
Configure your MCP client to run the server with npx (see examples below). Start Godot with your project open, and your MCP client will connect automatically.
Add to ~/.claude.json:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "@ryanmazzolini/minimal-godot-mcp"]
}
}
}
Add to .cursor/mcp.json in your project:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "@ryanmazzolini/minimal-godot-mcp"]
}
}
}
Configure your client to run:
npx -y @ryanmazzolini/minimal-godot-mcp
All optional — defaults work for most setups.
Pass these as env in your MCP client config:
{
"mcpServers": {
"godot": {
"command": "npx",
"args": ["-y", "@ryanmazzolini/minimal-godot-mcp"],
"env": {
"GODOT_WORKSPACE_PATH": "/path/to/your/godot/project"
}
}
}
}
.gd files in a projectget_diagnosticsCheck a single GDScript file for errors.
// Input
{ "file_path": "/path/to/script.gd" }
// Output
{
"diagnostics": {
"/path/to/script.gd": [
{ "line": 5, "column": 14, "severity": "error", "message": "Expected identifier", "code": "parse-error" }
]
}
}
scan_workspace_diagnosticsScan all .gd files in the workspace (excludes addons/ and .godot/).
// Input
{}
// Output
{
"files_scanned": 150,
"files_with_issues": 3,
"scan_time_seconds": 1.5,
"diagnostics": { ... }
}
get_console_outputGet console output from Godot debug session. Requires a running scene (F5 in Godot).
// Input (all optional)
{
"limit": 50,
"category": "console",
"since": 1706000000000
}
// Output
{
"entries": [
{ "timestamp": 1706000001234, "category": "console", "message": "Player spawned", "source": "/project/player.gd", "line": 42 }
],
"total_buffered": 150
}
Categories: console (print statements), stdout, stderr (errors/warnings).
clear_console_outputClear the console output buffer.
// Input
{}
// Output
{ "cleared": true }
flowchart LR
MCP[MCP Client] <-->|stdio| Server[minimal-godot-mcp]
Server <-->|LSP :6007| Godot[Godot Editor]
Server <-.->|DAP :6006| Godot
See also:
Prerequisites: npm 12.0.1 with a supported Node.js release (^22.22.2, ^24.15.0, or >=26)
git clone https://github.com/ryanmazzolini/minimal-godot-mcp.git
cd minimal-godot-mcp
npm install && npm run build
Then use node /path/to/minimal-godot-mcp/dist/index.js instead of npx in your MCP client config.
npm test # Run tests
npm run lint # ESLint + Prettier
npm run build # Compile TypeScript
npm run format && npm test before submittingSee docs/troubleshooting.md for connection issues, missing diagnostics, and debug logging.
godot-mcp by @satelliteoflove provides runtime control, scene manipulation, screenshots, stack traces, and direct editor interaction through a Godot addon. This project handles the LSP and DAP side — diagnostics and console output with no addon needed.
The two servers are complementary and can run side by side.
MIT - see LICENSE
Lightweight MCP server bridging Godot LSP to MCP clients for GDScript validation
Tools
Noch keine Tool-Liste. Remote-Server erhalten eine nach dem ersten Health-Check.
FAQ
Kopieren Sie auf dieser Seite die stdio-Konfiguration für Cursor, Claude Desktop, Claude Code oder VS Code. Sie nutzt die Installation des Herausgebers, keinen PlugMCP-Proxy.
In diesem Eintrag ist keine erforderliche Umgebungsvariable aufgeführt.
Minimal Godot läuft lokal über stdio.
Zuletzt geprüft: 2026-10-28. Lightweight MCP server bridging Godot LSP to MCP clients for GDScript validation