Skip to content

fernforestgames/mcp-server-godot

Repository files navigation

Godot MCP server NPM Version

A Model Context Protocol (MCP) server that provides AI assistants with tools to interact with Godot projects. This server enables starting, stopping, and capturing output from Godot projects, as well as capturing screenshots for visual debugging and analysis.

Features

  • Tools: Run/stop Godot projects, search scenes by node type/name/properties, capture screenshots
  • Resources: Browse scenes and .tres files, query by resource type, monitor running projects with output streams

Prerequisites

  • Node 22+
  • Godot must be installed and accessible
  • GODOT_PATH environment variable must be configured

MCP configuration

Add this server to your .mcp.json:

{
  "mcpServers": {
    "godot": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@fernforestgames/mcp-server-godot",
        "/path/to/your/godot/project"
      ],
      "env": {
        "GODOT_PATH": "/path/to/godot/executable"
      }
    }
  }
}

License

Released under the MIT License. See the LICENSE file for details.