Funplay MCP for Godot

Funplay MCP for Godot is an MIT-licensed editor plugin that turns the Godot Editor into a local MCP server, allowing AI assistants to inspect, edit, and automate your running Godot project.

It is designed for Godot 4.2+ projects and works with both standard GDScript projects and Godot .NET / C# projects.

Highlights

• Local MCP server running inside the Godot Editor
• One-click client configuration for Codex, Claude Code, Cursor, and VS Code
• Scene and node inspection tools
• Script creation, editing, patching, and refactor planning
• UI authoring helpers for Control-based interfaces
• Project file read/write/search tools with project-root path protection
• Interactive project map export with scenes, scripts, functions, signals, and dependencies
• Runtime bridge tools for play-mode scene tree inspection
• Asset import planning helpers for CC0/permissive asset workflows
• Release readiness checks for GitHub Release, npm wrapper, MCP Registry, and Asset Library packaging

Security

The plugin binds its HTTP server to 127.0.0.1 only.

Since v0.9.1, local MCP POST requests require a per-project auth token. The built-in dock automatically writes token-aware stdio client configs. Browser-style requests with non-local Origin or Referer headers are rejected, and project file/resource paths are normalized to stay under res://.

Requirements

• Godot 4.2 or newer
• Editor plugin enabled in Project Settings
• Node.js 18+ only if using the optional npm stdio wrapper

Tested with Godot 4.6.3-stable.

Installation

1. Download the release package.
2. Copy or extract addons/funplay_mcp into your Godot project.
3. Enable Funplay MCP for Godot in Project Settings → Plugins.
4. Open the Funplay MCP dock.
5. Click Configure for your AI client.

MCP Clients

The plugin can generate config entries for:

• Codex
• Claude Code / Claude Desktop compatible configs
• Cursor
• VS Code MCP configs

The recommended connection path is the npm stdio wrapper:

```bash npx -y funplay-godot-mcp