Как настроить MCP для Godot и установить godot-mcp (Cursor, OpenCode)

Как настроить MCP для Godot и установить godot-mcp

Godot MCP (часто ищут как godot-mcp, с опечаткой gobot-mcp) — это MCP (МСП)‑плагин для связи редактора Godot (Годот) с Cursor (Курсор), OpenCode или другим MCP‑клиентом. Настройка в пять шагов:

1. Скачайте godot-mcp → папка в addons/ проекта
2. Project → Project Settings → Plugins → включите Godot MCP Server
3. Панель GodotMCP → Start → статус Running (порт 3000)
4. One-click configure для Cursor (или вашей IDE)
5. В Cursor в списке MCP появится godot-mcp — проверьте read-only промптом

Не путайте с обычным аддоном. Запросы вроде «как установить плагин в Godot» или «как добавить аддон» чаще про AssetLib и любые плагины редактора — см. раздел ниже.

Чеклист включения (сначала пробегитесь глазами)

1. Папка плагина: addons/<имя-плагина>/ (без лишнего уровня распаковки)
2. Project Settings → Plugins: Godot MCP Server включён
3. Панель GodotMCP показывает Running
4. В списке MCP Cursor есть godot-mcp (при необходимости Reload)
5. Read-only промпт перечисляет корневые узлы активной сцены

Репозиторий: DaxianLee/godot-mcp · Страница продукта: 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 в Project Settings

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.

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

Обычный плагин или аддон vs Godot MCP

Вопрос из поиска	Это про…	Куда идти
«Как установить плагин в Godot»	Любой плагин / аддон	Project → AssetLib или скачать ZIP → addons/ → Plugins
«Где открыть плагины в Godot»	Вкладка плагинов	Project Settings → Plugins (или Editor → Manage Plugins в Godot 4)
«Как настроить MCP для Godot»	Мост к Cursor / ИИ	Эта статья — godot-mcp + Running + MCP в IDE
«Как подключить Cursor к Godot по MCP»	IDE + godot-mcp	Шаги 4–5 выше; также OpenCode / Continue

Godot MCP — один конкретный аддон из GitHub для Model Context Protocol. Остальные аддоны (анимация, UI, сеть) ставятся так же через addons/, но не дают tools в Cursor, пока это не MCP‑сервер.

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

Как настроить MCP для Godot? Скачайте godot-mcp → addons/ → включите в Plugins → Start на панели GodotMCP → one-click configure в Cursor. Подробно — шаги 1–5 выше.

Как установить godot-mcp / gobot-mcp? Официальное имя — godot-mcp (репозиторий). Опечатка gobot в поиске ведёт к тому же плагину.

Как подключить Cursor по MCP к Godot? Godot с Running сервером + godot-mcp в списке MCP Cursor (Reload при необходимости). Godot и Cursor на одной машине.

Подключение OpenCode по MCP к Godot? Тот же локальный сервер godot-mcp; в OpenCode добавьте MCP‑endpoint с адресом из панели GodotMCP (как для Cursor, другой клиент).

Как установить / включить / добавить аддон в Godot (не MCP)?

1. AssetLib в редакторе → Install → активируйте в Project Settings → Plugins, или
2. Скачайте ZIP → распакуйте в res://addons/<имя>/ → включите на вкладке Plugins.

Где в Godot вкладка плагины? Project → Project Settings → Plugins — список аддонов проекта; AssetLib — каталог для установки новых.

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

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

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

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

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

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

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