Godot MCP

Godot MCP

tugcantopalogluMIT
239 звёзд42 форков
Godot MCP — сервер для протокола MCP. Он подключает AI-ассистента к игровому движку Godot 4.x. Разработчики управляют проектами, сценами, анимацией и кодом через диалог с нейросетью. В сервере 165 инструментов: от создания проекта до выполнения GDScript-кода в реальном времени. Средства покрывают работу с сетью, 2D/3D-рендеринг, UI, аудиоэффекты, анимацию, файловую систему, физику и сигналы. Большинство операций выполняются на лету, без остановки игры. Это ускоряет прототипирование механик и отладку логики. Проект — форк оригинального godot-mcp от Coding-Solo. Сообщество расширило его с 20 инструментов до 165.
Ai-mlGaming
Открыть на GitHubОфициальный сайт

Установка

npx -y @tugcantopaloglu/godot-mcp

Характеристики

Общее

  • СтатусСообщество
  • Разработчикtugcantopaloglu
  • ЛицензияMIT

Технологии

  • Языки
    JavaScript
  • Транспорт
    stdio

Описание

Возможности

  • Выполнять GDScript-код в работающей игре с получением результата.
  • Читать и изменять свойства любого узла по пути.
  • Вызывать методы узлов с аргументами.
  • Добавлять, удалять и перепривязывать узлы и сцены во время выполнения.
  • Управлять анимациями и твинами с настраиваемым сглаживанием.
  • Подключать, отключать и отправлять сигналы между узлами.
  • Управлять 3D/2D-сценами, физикой, UI и аудиоэффектами.
  • Создавать и настраивать проекты Godot с нуля.
  • Инспектировать полное дерево узлов, их свойства и дочерние элементы.
  • Переключать сцены и управлять файловой системой проекта.

Как подключить

Установите сервер через Node.js:

npx -y @tugcantopaloglu/godot-mcp

Добавьте конфигурацию в файл claude_desktop_config.json вашего MCP-клиента:

{ "mcpServers": { "godot-mcp": { "command": "npx", "args": ["-y", "@tugcantopaloglu/godot-mcp"] } } }

Перезапустите клиент (Claude Desktop или другой).

Примеры запросов

Вот что вы можете попросить AI-ассистента сделать через этот сервер:

  • «Создай новый 3D-проект с простой сценой и направленным источником света.»
  • «Найди узел CharacterBody3D и установи его скорость на 10.»
  • «Покажи все анимации, которые есть в AnimationPlayer корневой сцены.»
  • «Выполни GDScript-код: получи текущий счет игрока и увеличь его на 100.»
  • «Создай UI-элемент Button с текстом "Начать игру" и подключи к нему сигнал pressed.»

Технические детали

  • Язык: TypeScript (JavaScript)
  • Транспорт: stdio
  • Лицензия: MIT
  • Клиенты: Claude Desktop, Cursor, Continue.dev и любые другие MCP-клиенты.
  • Версия Godot: 4.x

Поделиться