Премиальный сервер MCP (Model Context Protocol) для разработки игр Godot на базе ИИ. Соединяет AI-ассистентов, таких как Claude, напрямую с вашим редактором Godot с помощью 187 мощных инструментов.

Архитектура

• В реальном времени: WebSocket-соединение означает мгновенную обратную связь, без опроса файлов
• Интеграция с редактором: Полный доступ к API редактора Godot, системе UndoRedo и дереву сцен
• JSON-RPC 2.0: Стандартный протокол с правильными кодами ошибок и предложениями

Что в этом репозиторе

⚠️ Этот публичный репозиторий содержит только бесплатный аддон/плагин Godot. MCP-сервер (Node.js, необходимый для подключения AI-ассистентов) распространяется в платном пакете — одноразовая покупка, пожизненные обновления:

• Купи мне кофе:
• itch.io:

Платный архив включает дополнение, каталог server/ с готовыми инструкциями JavaScript, INSTALL.md и AI-клиента. Если вы клонировали этот репозиторий и не видите папку server/, это ожидаемо — скачайте полный пакет по одной из ссылок выше.

Быстрый старт

1. Установите плагин Godot

Скопируйте папку addons/godot_mcp/ в каталог addons/ вашего проекта Godot.

Godot MCP Pro

Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor with 187 powerful tools.

Architecture

AI Assistant ←—stdio/MCP—→ Node.js Server ←—WebSocket:6505—→ Godot Editor Plugin

• Real-time: WebSocket connection means instant feedback, no file polling
• Editor Integration: Full access to Godot’s editor API, UndoRedo system, and scene tree
• JSON-RPC 2.0: Standard protocol with proper error codes and suggestions

What’s in this repo

⚠️ This public repo only contains the free Godot addon/plugin. The MCP server (Node.js, required to connect AI assistants) is distributed as part of the paid package — one-time purchase, lifetime updates:

• Buy Me a Coffee:
• itch.io:

The paid zip includes the addon, the server/ directory with pre-built JavaScript, INSTALL.md, and AI-client instructions. If you cloned this repo and don’t see a server/ folder, that’s expected — grab the full package from one of the links above.

Quick Start

1. Install the Godot Plugin

Copy the addons/godot_mcp/ folder into your Godot project’s addons/ directory.

Enable the plugin: Project → Project Settings → Plugins → Godot MCP Pro → Enable

2. Install the MCP Server

The server/ directory is only included in the full paid package (see above). After downloading and extracting the zip, run:

cd server
npm install
npm run build

3. Configure Claude Code

Add to your .mcp.json:

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js"],
      "env": {
        "GODOT_MCP_PORT": "6505"
      }
    }
  }
}

4. Choose Your Mode

Godot MCP Pro offers four modes to fit any client’s tool limit:

--3d includes the core tools plus physics, AnimationTree and navigation, but omits uid_to_project_path, project_path_to_uid, compare_screenshots, clear_output, close_script, reload_open_scripts, set_anchor_preset and click_button_by_text to stay within the 100-tool cap.

{
  "mcpServers": {
    "godot-mcp-pro": {
      "command": "node",
      "args": ["/path/to/server/build/index.js", "--lite"]
    }
  }
}

Replace --lite with --minimal for the smallest footprint.

• Lite includes: project, scene, node, script, editor, input, runtime, and input_map tools.