Godot MCP

Godot MCP — MCP-сервер сообщества (автор — tugcantopaloglu). Полное управление движком Godot 4.x: 165 инструментов для разработки игр с ИИ. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
tugcantopaloglu
Лицензия
MIT
Транспорт
stdio
Авторизация
none
ОС
Не указана
Языки
typescript

Уровень риска: high

game_eval выполняет произвольный GDScript; чтение, запись и удаление файлов проекта; GODOT_MCP_ALLOWED_DIRS ограничивает корни.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/godot-mcp/build/index.js\"]\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Godot MCP — Full Control — MCP-сервер, который даёт ИИ-ассистенту полный контроль над игровым движком Godot: 157 инструментов. Это форк проекта godot-mcp от Coding-Solo: оригинал давал 20 инструментов для управления проектом и сцен.

Основные группы инструментов по README:

  • проект и сцены: создание проектов (в том числе C# / .NET), чтение и изменение project.godot, работа со сценами .tscn без запуска игры (read_scene, modify_scene_node, attach_script, create_resource);
  • выполнение во время игры: game_eval выполняет произвольный GDScript в запущенной игре, есть чтение и запись свойств любых узлов, вызов методов, добавление и удаление узлов, смена сцены;
  • сигналы, анимация и твины, ввод (в том числе синтетический), пауза, метрики производительности;
  • файлы: read_file, write_file, delete_file, создание папок внутри проектов Godot;
  • ошибки и логи: новые сообщения push_error и print запущенной игры;
  • проверка GDScript: синтаксические и типовые ошибки без запуска игры (validate_script, validate_scripts);
  • 3D и 2D, физика, звук, сеть, интерфейс, окно системы, инструменты редактора, а также сборка и экспорт.

Кому подойдёт

  • Разработчикам игр на Godot, которые хотят собирать сцены, писать скрипты и отлаживать игру вместе с ассистентом.
  • Тем, кто тестирует геймплей: управление запущенной игрой, чтение ошибок и метрик.

Похожие серверы — в категории 3D и геймдев.

Установка

Требования: Godot 4.4 или новее (проверено на 4.7), Node.js 18+, а для C# — .NET SDK 8.0+ и сборка Godot .NET.

git clone https://github.com/tugcantopaloglu/godot-mcp.git
cd godot-mcp
npm install
npm run build

Для инструментов game_* в проект нужно добавить автозагрузку: скопируйте build/scripts/mcp_interaction_server.gd и зарегистрируйте его в Project > Project Settings > Autoload под именем McpInteractionServer. Сервер взаимодействия слушает 127.0.0.1:9090, пока игра запущена.

Подключение к клиентам

Конфиги приведены дословно из README. Укажите абсолютный путь к собранному build/index.js. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "godot": {
      "command": "node",
      "args": ["/absolute/path/to/godot-mcp/build/index.js"],
      "env": {
        "GODOT_PATH": "/path/to/godot",
        "DEBUG": "true"
      }
    }
  }
}

GODOT_PATH задаёт путь к исполняемому файлу Godot, если автоопределение не сработало. Для Cline в README есть такой же блок для cline_mcp_settings.json.

Проверка

Попросите ассистента прочитать настройки проекта или дерево сцены .tscn. Чтобы проверить инструменты времени выполнения, запустите игру с автозагрузкой McpInteractionServer и попросите показать FPS и число объектов.

Примеры задач

Создай сцену с игроком на CharacterBody2D, добавь скрипт движения и проверь его через validate_script.
Запусти игру, найди все узлы группы enemies и выведи последние ошибки из лога.

Риски

  • Выполнение кода. game_eval и сгенерированные скрипты выполняют произвольный GDScript с правами учётной записи, под которой работает Godot. Для непроверенного кода README советует отдельную учётную запись или контейнер.
  • Файлы. Инструменты читают, пишут и удаляют файлы и сцены проекта. Пути проверяются, чтобы не выходить за пределы папки проекта, включая символические ссылки. Переменная GODOT_MCP_ALLOWED_DIRS ограничивает инструменты заданными корневыми папками.
  • Работайте в проекте под контролем версий, чтобы откатить нежелательные изменения сцен и скриптов.
  • Сервер взаимодействия с игрой слушает только 127.0.0.1:9090.

Частые вопросы

Какая версия Godot нужна?

4.4 или новее. Авторы проверяли сервер на Godot 4.7.

Нужна ли запущенная игра?

Не для всех инструментов: работа со сценами, настройками и проверка скриптов не требуют запуска. Инструменты game_* работают только с запущенной игрой и автозагрузкой.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники