Godot MCP: установка через addons и подключение AI IDE

Что рассматривается в этом руководстве

Следуйте этим пяти шагам, чтобы подключить open-source Godot MCP к локальному проекту Godot, чтобы Cursor (или другая AI IDE с поддержкой MCP) мог управлять редактором, просматривать и отлаживать его, а не просто редактировать скрипты на диске.

Когда вы закончите, вы сможете:

• Разместить плагин в папке addons проекта и включить его
• Запустить локальный Godot MCP Server (порт по умолчанию 3000)
• Использовать настройку в один клик для регистрации сервера в Cursor и подтверждения соединения

Репозиторий с открытым исходным кодом: DaxianLee/godot-mcp

Предварительные требования

Элемент	Примечания
Godot	Установлен, с проектом, который можно открыть
Пакет плагина	Релиз godot-mcp или ZIP-архив исходного кода с GitHub
AI IDE	Рекомендуется Cursor; другие MCP-клиенты также подходят
Локальная сеть	MCP-мост обычно работает на 127.0.0.1 — не открывайте порт публично

Шаг 1: Загрузите Godot MCP

Загрузите open-source Godot MCP с GitHub:

Репозиторий: https://github.com/DaxianLee/godot-mcp

Рекомендуемый порядок действий:

1. Откройте репозиторий и используйте Code → Download ZIP, или возьмите последний пакет из Releases
2. Сохраните архив локально и подготовьтесь к извлечению
3. Убедитесь, что пакет выглядит как плагин Godot (папка, связанная с addons, или папка плагина, которую можно поместить в addons)

Шаг 2: Добавьте Godot MCP в ваш проект

1. Извлеките архив на вашем компьютере
2. Переместите извлеченную папку плагина в каталог addons в корне проекта Godot
   • Если addons еще не существует, создайте его сначала
3. Откройте (или перезагрузите) проект в Godot и убедитесь, что файлы плагина появились в панели FileSystem

Пример структуры проекта после импорта:

Шаг 3: Включите плагин Godot MCP

1. Откройте Project → Project Settings (или эквивалент для вашей версии Godot)
2. Перейдите на вкладку Plugins
3. Найдите Godot MCP Server (название может незначительно отличаться в интерфейсе)
4. Включите его

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

Шаг 4: Запустите Godot MCP Server

1. В редакторе Godot на правой панели откройте док GodotMCP
2. Просмотрите и при необходимости настройте:
   • Port: по умолчанию 3000
   • Language: выберите соответствующий вашему интерфейсу язык
   • Startup: вы можете включить auto-start, чтобы сервер запускался при открытии проекта
3. Нажмите Start
4. Когда на панели отобразится Running (или локализованный эквивалент), Godot MCP Server запущен

Теперь у вас есть локальный MCP-мост. Далее передайте его вашей AI IDE.

Шаг 5: Настройка AI IDE в один клик (пример с Cursor)

1. В панели GodotMCP откройте Tools
   • Просмотрите инструменты, предоставляемые сервером
   • Включите только те возможности, которые вы хотите предоставить AI
2. Откройте Configure
   • Выберите вашу IDE (например Cursor)
   • Нажмите One-click configure
   • Дождитесь сообщения configuration successful
3. Откройте Cursor
   • В списке MCP / инструментов вы должны увидеть godot-mcp, подключенный автоматически
   • Если он не появился, нажмите Reload (или эквивалентное действие перезагрузки MCP) в Cursor и проверьте снова

Настройка и подключение:

Быстрая проверка после подключения

В Cursor начните с проверки только на чтение, например:

Перечислите корневые узлы активной сцены Godot.

Если ответ соответствует иерархии редактора, мост работает. Затем попробуйте небольшую запись (создайте временный узел и удалите его), чтобы подтвердить разрешения и выбор инструментов.

Часто задаваемые вопросы

Я скопировал файлы в addons, но Godot MCP Server отсутствует в списке плагинов? Убедитесь, что папка находится по пути addons/<имя-плагина>/ и не вложена в дополнительный уровень распаковки. Перезагрузите проект или перезапустите Godot.

Я нажал Start, но никогда не вижу Running? Убедитесь, что порт 3000 (или ваш пользовательский порт) свободен, затем повторите попытку. Проверьте, что ничего не блокирует localhost.

Cursor не показывает godot-mcp? В Godot убедитесь, что сервер все еще Running, выполните настройку в один клик еще раз, затем перезагрузите MCP в Cursor. Если это не помогло, проверьте, что конфигурация MCP в Cursor включает адрес локального моста.

Автозапуск включен, но мне все равно приходится запускать вручную? Некоторые сборки требуют сначала одного успешного ручного запуска. Убедитесь, что флажок сохранен, затем снова откройте тот же проект и проверьте.

Следующие шаги

• Используйте естественный язык для запроса сцены или небольшого редактирования, чтобы изучить границы инструмента
• Делайте коммит перед большими изменениями; держите мост только на localhost
• Для передачи дизайна в движок используйте пару с VberAI AI Studio, затем дорабатывайте в редакторе с помощью MCP

Для дополнительной информации о Godot + MCP см. Как мы создали MCP-сервер реального времени для Godot.