mcp-server

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

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

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

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

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

Правит и переименовывает файлы проекта Godot на диске (Ctrl+Z не действует, есть mcp_undo); локальные порты 6505 и 6510.

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

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"godot\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"godot-mcp-server\"]\n    }\n  }\n}",
    "lang": "json",
    "notes": "Settings → MCP → Add Server, дословно из README",
    "verified": "docs"
}

Что умеет

Godot MCP Server даёт ИИ-ассистенту полный доступ к редактору Godot. Claude, Cursor или другой MCP-клиент читает, пишет и меняет сцены, скрипты, узлы и настройки проекта прямо в редакторе, без копирования кода туда и обратно. Требуется Godot 4.4+, лицензия MIT.

Сервер работает в связке с плагином для Godot: MCP-сервер на Node.js общается с клиентом по stdio, а с редактором — через WebSocket на порту 6505. Ассистент видит живое состояние проекта, а не догадывается о его структуре.

Группы инструментов по таблице README (в шапке README указано 69 инструментов, таблица описывает 32 в шести категориях):

  • файлы: просмотр папок, чтение файлов, поиск по проекту, создание скриптов;
  • сцены: создание сцен, добавление, удаление и перемещение узлов, свойства, прикрепление скриптов, формы столкновений и текстуры;
  • скрипты: правки кода, проверка синтаксиса, переименование и перемещение файлов с обновлением ссылок;
  • проект: настройки, карта ввода, слои столкновений, ошибки консоли, дампы дерева сцены;
  • генерация ассетов: 2D-спрайты из SVG;
  • визуализация: map_project открывает в браузере карту проекта на localhost:6510 — граф скриптов и связей, правка кода с синхронизацией в Godot, поиск использований перед рефакторингом.

Есть отмена изменений ИИ через инструмент mcp_undo.

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

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

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

Установка

  1. Установите Node.js (LTS) с nodejs.org. Клонировать и собирать сервер не нужно — он запускается через npx.
  2. Скопируйте папку addons/godot_mcp/ из репозитория tomyud1/godot-mcp в папку addons/ своего проекта и включите плагин в Project → Project Settings → Plugins. Плагин также есть в Asset Store (Godot 4.7+, «Godlink MCP») и AssetLib.
  3. Перезапустите проект. В правом верхнем углу редактора должна появиться зелёная надпись «MCP: Agent Active».

Чтобы собрать сервер из исходников, выполните npm install и npm run build в godot-mcp/mcp-server и укажите клиенту путь к mcp-server/dist/index.js.

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

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "godot": {
      "command": "npx",
      "args": ["-y", "godot-mcp-server"]
    }
  }
}

В Cursor блок добавляется через Settings → MCP → Add Server. По README сервер работает и с другими MCP-клиентами (Claude Code, Cline, Windsurf).

Проверка

Убедитесь, что в редакторе горит «MCP: Agent Active», и попросите ассистента показать дерево текущей сцены или настройки проекта.

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

Создай сцену уровня с TileMap и игроком на CharacterBody2D, прикрепи скрипт движения и проверь синтаксис.
Запусти map_project и найди, где используется сигнал health_changed, прежде чем я его переименую.

Риски

  • Изменение файлов проекта. Ассистент создаёт и правит сцены и скрипты, переименовывает и перемещает файлы. Плагин пишет изменения на диск, а не в живое дерево редактора, поэтому Ctrl+Z в Godot их не отменяет — используйте mcp_undo и систему контроля версий.
  • Локальные порты. Сервер связывается с редактором через WebSocket на порту 6505 и поднимает визуализатор на localhost:6510; удалённые подключения не поддерживаются.
  • Одновременно поддерживается один редактор Godot; несколько клиентов делят его между собой.

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

Нужно ли собирать сервер?

Нет, он запускается через npx. Сборка из исходников нужна только если вы хотите менять код сервера.

Можно ли отменить изменения ИИ?

Да, инструментом mcp_undo. Обычная отмена Godot (Ctrl+Z) не действует, потому что изменения пишутся прямо на диск.

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

Источники