mcp -godot

This MCP server provides tools to interact with Godot projects through a unified agent interface. It can start and stop Godot projects, enumerate and search scenes by node type, name, or properties, and capture screenshots for visual debugging. You can also browse Godot resources like scenes and .tres files, query resources by type, and monitor the output streams of running Godot projects. Use it to orchestrate automated testing, debugging, or AI-assisted project exploration by issuing appropriate MCP tool invocations and consuming the resulting outputs and artifacts.

Prerequisites:

• Node.js 22+ installed on your system
• Godot installed and accessible via your environment
• GODOT_PATH environment variable configured to point to your Godot executable

Installation steps:

1. Install Node.js 22+ if you haven’t already
2. Install the MCP Godot server package globally (recommended) or ensure it can be run via npx: npm i -g @fernforestgames/mcp-server-godot
3. Confirm your MCP configuration (e.g., in .mcp.json) includes the godot server block as shown in the README: { "mcpServers": { "godot": { "type": "stdio", "command": "npx", "args": [ "@fernforestgames/mcp-server-godot", "/path/to/your/godot/project" ], "env": { "GODOT_PATH": "/path/to/godot/executable" } } } }
4. Run the MCP server according to your environment (via npx or your installed binary) and verify it connects to the specified Godot project.
5. If needed, adjust GODOT_PATH and the Godot project path to ensure correct operation.

Environment variables:

• GODOT_PATH should point to the Godot executable (e.g., /usr/bin/godot or C:\Program Files\Godot\godot.exe).

Configuration tips:

• The server exposes tools for starting/stopping Godot projects, searching scenes by node type/name/properties, and capturing screenshots. Ensure your Godot project is accessible at the specified path and that the Godot version is compatible with the MCP server expectations.
• When debugging, monitor the output streams of running projects to correlate agent actions with logs. If Godot fails to start, double-check that the GODOT_PATH is correct and that the project path is valid.
• You can extend or modify the .mcp.json configuration to point to different projects or multiple Godot instances if needed.