Godot MCP Native (Model Context Protocol)

中文版本

A powerful Godot Engine plugin that integrates AI assistants (Claude, etc.) via the Model Context Protocol (MCP). Enable AI to directly read and modify your Godot projects - scenes, scripts, nodes, and resources - all through natural language.

🚀 Features

• Full Project Access: AI assistants can read and modify scripts, scenes, nodes, and resources
• Native Implementation: No Node.js dependency required - runs entirely within Godot
• Real-time Editing: Apply AI suggestions directly in the editor
• Comprehensive Tool Set (154 tools — 30 core + 124 supplementary):
  • Node Tools (9 core + 11 advanced): Create, modify, manage scene nodes, duplicate, move, rename, signal connections, anchor presets, group management, batch operations, scene auditing
  • Script Tools (7 core + 8 advanced): Edit, analyze, create, attach, validate GDScript files, execute scripts, search in files, symbol indexing, definition & reference lookup
  • Scene Tools (4 core + 4 advanced): Manipulate scene structure, save scenes, list/open/close scene tabs, project scene listing
  • Editor Tools (4 core + 12 advanced): Control editor functionality, screenshot, signal inspection, filesystem reload, node/file selection, export management, property inspector
  • Debug Tools (3 core + 66 advanced): Logging, debugger sessions, breakpoints, stack/variable inspection, profilers, runtime probe, animation/audio/shader/tilemap runtime control, debug execution control
  • Project Tools (3 core + 23 advanced): Access project settings, list resources, create resources, run tests, manage input mappings, inspect autoloads/global classes, resource diagnostics & health audit

📦 Installation

Method 1: Asset Library (Recommended)

1. Open your Godot project
2. Go to AssetLib tab in the editor
3. Search for "Godot MCP Native"
4. Click Download and then Install

Method 2: Manual Installation

1. Download or clone this repository
2. Copy the addons/godot_mcp folder to your project's addons/ directory
3. Open your project in Godot
4. Go to Project > Project Settings > Plugins
5. Enable "Godot MCP Native" plugin

🔧 Usage

Enabling the Plugin

1. Open Project > Project Settings > Plugins
2. Locate "Godot MCP Native" in the list
3. Set the status to Enable

Configuring MCP Server

The plugin provides two transport modes:

HTTP Mode (for remote access)

• Best for: Network-based AI integration
• Configuration: Set transport_mode = "http" and configure http_port (default: 9080)
• Optional: Enable auth_enabled and set auth_token for security

Connecting with Claude Desktop

First, install the mcp-remote package:

npm install mcp-remote

HTTP Mode Configuration

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

Connecting with Cursor / Trae

HTTP Mode Configuration

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp"
    }
  }
}

With authentication:

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp",
      "headers": {
        "Authorization": "Bearer your-secret-token-here"
      }
    }
  }
}

Connecting with Cline

HTTP Mode Configuration

{
  "mcpServers": {
    "godot-mcp": {
      "url": "http://localhost:9080/mcp",
      "type": "streamableHttp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Connecting with OpenCode

HTTP Mode Configuration

{
  "mcp": {
    "godot-mcp": {
      "type": "remote",
      "url": "http://localhost:9080/m

... [View full README on GitHub](https://github.com/yurineko73/Godot-MCP-Native#readme)