Godot MCP Native

v1.0.0Developer Toolsstable

一款支持godot开源引擎的的mcp插件,支持常见godot引擎操作,使用Godot原生实现MCPServer,无需安装依赖,开箱即用,支持多种AI工具调用。An MCP plugin that supports the open-source Godot engine, enabling common Godot engine operations. It implements the MCP Server using Godot's native HTTP, requires no depe

godot-mcp-nativemcpai-integration
Share:
138
Stars
0
Downloads
0
Weekly
0/5

What is Godot MCP Native?

Godot MCP Native is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 一款支持godot开源引擎的的mcp插件,支持常见godot引擎操作,使用godot原生实现mcpserver,无需安装依赖,开箱即用,支持多种ai工具调用。an mcp plugin that supports the open-source godot engine, enabling common godot engine operations. it implements the mcp ...

一款支持godot开源引擎的的mcp插件,支持常见godot引擎操作,使用Godot原生实现MCPServer,无需安装依赖,开箱即用,支持多种AI工具调用。An MCP plugin that supports the open-source Godot engine, enabling common Godot engine operations. It implements the MCP Server using Godot's native HTTP, requires no depe

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • 一款支持godot开源引擎的的mcp插件,支持常见godot引擎操作,使用Godot原生实现MCPServer,无需安装

Use Cases

Interact with Godot engine operations using native MCP implementation.
Enable AI tools to control game engine development workflows.
yurineko73

Maintainer

LicenseMIT
Languagegdscript
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx godot-mcp-native

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Godot MCP Native

Godot MCP Native is a Godot Engine 4.x plugin that implements a full MCP server directly inside the Godot editor using Godot's native HTTP support, requiring no Node.js, Python, or external runtimes. It exposes 154 tools across node management, GDScript editing, scene manipulation, editor control, debug sessions, and project settings — allowing AI assistants like Claude to read and modify Godot projects, scenes, scripts, and resources through natural language. Game developers who want AI assistance integrated directly into their Godot workflow without leaving the editor will benefit most from this plugin.

Prerequisites

  • Godot Engine 4.x installed
  • An MCP-compatible client such as Claude Desktop, Cursor, Cline, or OpenCode
  • npm and npx available (for Claude Desktop, which requires the mcp-remote bridge package)
  • No additional runtime dependencies — the MCP server runs natively inside Godot
1

Install the plugin via the Godot Asset Library

Open your Godot project, switch to the AssetLib tab, search for 'Godot MCP Native', and click Download then Install.

2

Enable the plugin in Project Settings

Go to Project > Project Settings > Plugins in the Godot editor, find 'Godot MCP Native' in the list, and set its status to Enabled.

3

Configure the transport mode

The plugin supports HTTP mode (for remote AI client access) and stdio mode. HTTP mode on port 9080 is the recommended mode for most MCP clients. Configure this in the plugin panel inside the Godot editor.

4

Install mcp-remote for Claude Desktop

Claude Desktop requires the mcp-remote bridge package to connect to HTTP-based MCP servers.

npm install -g mcp-remote
5

Add the server to your MCP client configuration

Configure your MCP client to connect to the Godot MCP server. For Claude Desktop use mcp-remote; for Cursor and Cline use the direct HTTP URL.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:9080/mcp"
      ]
    }
  }
}
6

Open your Godot project and start using AI tools

With Godot running and the plugin enabled, restart your MCP client. The AI assistant can now read scenes, edit scripts, create nodes, and control the editor through natural language.

Godot MCP Native Examples

Client configuration

Claude Desktop configuration using mcp-remote to connect to the Godot MCP HTTP server on the default port.

{
  "mcpServers": {
    "godot-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:9080/mcp"
      ]
    }
  }
}

Prompts to try

Example prompts for interacting with your Godot project via the MCP server.

- "List all nodes in the current scene"
- "Create a new CharacterBody2D node named Player in the root scene"
- "Show me the content of res://scripts/player.gd"
- "Add a CollisionShape2D to the Player node"
- "Take a screenshot of the current editor viewport"
- "List all GDScript files in the project"

Troubleshooting Godot MCP Native

MCP client cannot connect — connection refused on port 9080

Ensure Godot is running with the project open and the Godot MCP Native plugin is enabled. The HTTP server only starts when the plugin is active. Check the Godot output panel for server startup messages.

Multiple Godot projects conflict on the same port

Launch additional project instances with a different port using the `--mcp-port` flag: `godot --editor --path /path/to/project -- --mcp-server --mcp-port=19081`. Update your MCP client config to point to the correct port for each project.

Claude Desktop fails to connect even with mcp-remote installed

Verify mcp-remote is installed globally and accessible: `npx mcp-remote --version`. Ensure the Godot project is open and the plugin is enabled before starting Claude Desktop. Check that no firewall is blocking localhost:9080.

Frequently Asked Questions about Godot MCP Native

What is Godot MCP Native?

Godot MCP Native is a Model Context Protocol (MCP) server that 一款支持godot开源引擎的的mcp插件,支持常见godot引擎操作,使用godot原生实现mcpserver,无需安装依赖,开箱即用,支持多种ai工具调用。an mcp plugin that supports the open-source godot engine, enabling common godot engine operations. it implements the mcp server using godot's native http, requires no depe It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Godot MCP Native?

Follow the installation instructions on the Godot MCP Native GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Godot MCP Native?

Godot MCP Native works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Godot MCP Native free to use?

Yes, Godot MCP Native is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "godot-mcp-native": { "command": "npx", "args": ["-y", "godot-mcp-native"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Godot MCP Native?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides