godot-mcp

godot-mcp

tomyud1MIT
351 звёзд39 форков
Godot MCP подключает редактор Godot 4.x к AI-ассистентам. Работайте без копирования кода и переключения окон. AI читает, пишет и управляет сценами, скриптами и настройками проекта. В сервере 42 инструмента по шести категориям. AI создаёт персонажей, настраивает коллизии, редактирует код, запускает сцены и генерирует спрайты из SVG. Это ускоряет разработку игр: от прототипирования до финальной настройки. Сервер совместим с Claude Desktop, Cursor, Claude Code, Cline и Windsurf.
Ai-mlGaming
Открыть на GitHub

Установка

npx -y godot-mcp-server

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

Общее

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

Технологии

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

Описание

Возможности

  • Управляет файлами проекта: навигация, чтение, создание скриптов и ресурсов
  • Создаёт и редактирует сцены: добавление, перемещение и удаление узлов
  • Назначает свойства, скрипты, коллизии и текстуры узлам
  • Вносит правки в код, проверяет синтаксис GDScript
  • Переименовывает и перемещает файлы с обновлением ссылок
  • Запускает и останавливает игровые сцены в редакторе
  • Обращается к ClassDB Godot, читает ошибки из Output и Debugger
  • Редактирует Input Map, настройки слоёв коллизий и параметры проекта
  • Генерирует 2D-спрайты из SVG
  • Строит интерактивную карту проекта и граф сцены в браузере

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

1. Установите плагин в Godot

Откройте AssetLib в редакторе. Найдите «Godot AI Assistant tools MCP» и установите. Включите его в меню Project → Project Settings → Plugins.

2. Настройте MCP-клиент

Добавьте сервер в конфигурацию. Для Claude Desktop: Settings → Developer → Edit Config. Для Cursor: Settings → MCP → Add Server.

Mac / Linux:

{ "mcpServers": { "godot": { "command": "npx", "args": ["-y", "godot-mcp-server"] } } }

Windows:

{ "mcpServers": { "godot": { "command": "cmd", "args": ["/c", "npx", "-y", "godot-mcp-server"] } } }

Для Claude Code используйте команду claude mcp add godot -- npx -y godot-mcp-server

3. Запустите

Перезапустите AI-клиент и Godot. В правом верхнем углу редактора появится «MCP Connected» зелёным — сервер работает.

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

  • «Создай сцену с персонажем: добавь CharacterBody2D, скрипт с движением WASD и анимацию покоя.»
  • «Найди все файлы, которые импортируют класс Player, и построй граф зависимостей.»
  • «Измени Input Map: добавь действие Jump на клавишу Space и сделай двойной прыжок.»
  • «Сгенерируй спрайт монстра из SVG-файла enemy.svg и привяжи к узлу Sprite2D.»
  • «Проверь синтаксис player.gd, найди ошибки и исправь их.»

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

  • Язык реализации: GDScript
  • Транспортный протокол: stdio
  • Лицензия: MIT
  • Совместимость: Godot 4.x
  • Клиенты: Claude Desktop, Cursor, Claude Code, Cline, Windsurf
  • Установка: npx -y godot-mcp-server

Поделиться