godot-mcp

godot-mcp — MCP-сервер сообщества (автор — Coding-Solo). Работа с движком Godot: редактирование, запуск и отладка проектов, управление сценами. Лицензия MIT.

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

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

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

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

Запускает редактор и проекты Godot, создаёт и сохраняет сцены, пересохраняет ресурсы.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coding-solo/godot-mcp\"],\n      \"env\": {\n        \"DEBUG\": \"true\"\n      }\n    }\n  }\n}",
    "file": ".cursor/mcp.json",
    "lang": "json",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

Godot MCP — сервер для работы с игровым движком Godot. ИИ-агент может открыть редактор, запустить проект, получить отладочный вывод и остановить выполнение. Так у агента появляется обратная связь: он видит, что работает в реальном проекте Godot, а что нет, и точнее исправляет код.

Основное:

  • Редактор и запуск: открыть редактор Godot для нужного проекта (launch_editor), запустить проект в режиме отладки (run_project) и остановить его (stop_project).
  • Отладочный вывод: консольные сообщения и ошибки запущенного проекта (get_debug_output).
  • Проекты: версия установленного Godot, поиск проектов в папке, сведения о структуре проекта.
  • Сцены: создание сцен с выбранным корневым узлом, добавление узлов с настраиваемыми свойствами, загрузка спрайтов и текстур в узлы Sprite2D, экспорт 3D-сцен в ресурс MeshLibrary для GridMap, сохранение сцен, в том числе как вариантов.
  • UID для Godot 4.4+: получить UID файла и обновить ссылки на UID, пересохранив ресурсы.

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

  • Разработчикам игр на Godot: агент сам запускает проект, читает ошибки и правит скрипты.
  • Начинающим в Godot: создание сцен и узлов по описанию на естественном языке.
  • Тем, кто переходит на Godot 4.4+: обновление ссылок на UID в проекте.

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

Установка

Нужны установленный движок Godot и Node.js 18 или новее. Сервер запускается через npx @coding-solo/godot-mcp. Если Godot не находится автоматически, укажите путь к исполняемому файлу в переменной GODOT_PATH. Переменная DEBUG=true включает подробный журнал сервера. Можно собрать сервер из исходников: клонировать репозиторий, выполнить npm install и npm run build.

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

Команда и конфиг приведены дословно из README. В Cursor файл .cursor/mcp.json создаётся в папке проекта. Для Cline README приводит такой же конфиг со списком инструментов в autoApprove. Общий порядок — в инструкции как подключить MCP.

claude mcp add godot -- npx @coding-solo/godot-mcp

Проверка

Попросите агента показать версию Godot — сработает get_godot_version. Затем запустите свой проект и попросите прочитать отладочный вывод.

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

Запусти мой проект Godot и расскажи, какие ошибки появились в выводе.
Создай новую сцену с корневым узлом Node2D и добавь в неё спрайт игрока.

Риски

Сервер запускает редактор и проекты Godot на вашей машине, создаёт и сохраняет сцены, пересохраняет ресурсы при обновлении UID. Запущенный проект выполняет свои скрипты с правами пользователя.

Как снизить риски: работайте в проекте под Git, чтобы видеть и откатывать изменения сцен. Не добавляйте в autoApprove инструменты, которые меняют проект, если хотите подтверждать каждое действие. Путь к проекту должен указывать на папку с файлом project.godot. Лицензия — MIT.

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

Что делать, если сервер не находит Godot?

Задайте переменную GODOT_PATH с путём к исполняемому файлу Godot.

Работает ли управление UID в старых версиях?

Нет. Инструменты для UID рассчитаны на Godot 4.4 и новее.

Основы протокола — на странице что такое 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

Источники