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 ограничивает корни.
Настройка клиентов
{
"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.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
MCP Unity
Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.