Godot MCP Server

MCP server that bridges Claude Code with the Godot editor via WebSocket. This repo only provides the MCP server — the Godot addon must be installed separately.

Prerequisites

Install the Godot addon from: https://github.com/youichi-uda/godot-mcp-pro

The addon connects automatically to the MCP server at ws://localhost:6505 when the editor starts.

This repo is a free client for the premium addon Godot MCP Pro. Get the premium version here:

• itch.io — Godot MCP Pro

• Official site

Setup

1. Clone this repo

git clone https://github.com/neondeex/GodotMCP-Pro-Free-Client
cd GodotMCP-Pro-Free-Client

2. Install dependencies

npm install

3. Start the server

npm start

Configure Claude Code

Add this to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/GodotMCP-Pro-Free-Client/index.js"]
    }
  }
}

Or via CLI:

claude mcp add godot node -- /absolute/path/to/GodotMCP-Pro-Free-Client/index.js

How It Works

Claude Code  ──(MCP/stdio)──▶  MCP Server  ──(WebSocket :6505)──▶  Godot addon

1. Claude invokes a tool (e.g. get_scene_tree)

2. The MCP server forwards it as a JSON-RPC request to the Godot addon

3. Godot executes the command and returns the result

4. The MCP server relays the result back to Claude

The server tries ports 6505–6514 in order and binds to the first available one.