n24q02m/better-godot-mcp

n24q02m/better-godot-mcp

от n24q02m
Сервер для разработки игр на Godot Engine с AI-агентами: 17 инструментов для управления сценами, скриптами и ресурсами напрямую, без запуска редактора. Ускоряет создание прототипов.

ARCHIVED 2026-09-13 — This repository is no longer maintained. Use the Godot editor + GDScript CLI toolchain instead of this MCP server. Existing installations keep working but receive no updates or support.

Better Godot MCP

mcp-name: io.github.n24q02m/better-godot-mcp

Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.

Mode: stdio · http local non-relay CI codecov npm Docker License: Apache-2.0

TypeScript Node.js Godot Engine semantic-release Renovate

Sister projects from n24q02m (click to expand)
Project Tagline Tag
agent-chat-plugin Peer AI agents chat in a shared folder — no human relay, no orchestrator, wor... Tooling
better-code-review-graph Knowledge graph for token-efficient code reviews -- semantic search and call-... MCP
better-drive 2-way Google Drive sync with .driveignore filter — rclone engine, Windows tray Tooling
better-email-mcp IMAP/SMTP email for AI agents -- read, send, organize folders, and manage att... MCP
better-godot-mcp Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted g... MCP
better-notion-mcp Markdown-first Notion for AI agents -- pages, databases, blocks, and comments... MCP
better-semantic-release Drop-in python-semantic-release fork with built-in release-safety guards (orp... Tooling
better-telegram-mcp Telegram for AI agents -- messages, chats, media, and contacts across both bo... MCP
better-workspace-mcp Google Workspace MCP server (Docs/Drive/Calendar/Gmail/Sheets/Slides/Tasks/Ch... MCP
claude-plugins Claude Code plugin marketplace for the n24q02m MCP servers -- install web sea... Marketplace
imagine-mcp Image and video understanding + generation for AI agents -- across Gemini, Op... MCP
jules-task-archiver Chrome Extension for bulk operations on Jules tasks via batchexecute API -- a... Tooling
mcp-core Shared foundation for building MCP servers -- Streamable HTTP transport, OAut... MCP
mnemo-mcp Persistent AI memory with hybrid search and embedded sync. Open, free, unlimi... MCP
qwen3-embed Lightweight Qwen3 text embedding and reranking via ONNX Runtime and GGUF Library
skret Secrets without the server. CLI
tacet A self-distilling neuro-symbolic cascade that amortises LLM cost across knowl... Tooling
web-core Shared web infrastructure package for search, scraping, HTTP security, and st... Library
wet-mcp Open-source MCP server for AI agents: web search, content extraction, and lib... MCP

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

Инструменты были проиндексированы:
animation

Управление анимацией. Действия: create_player|add_animation|add_track|add_keyframe|list. Используйте инструмент help для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • anim_namestring

    Название анимации.

  • durationnumber

    Продолжительность анимации в секундах

  • loopboolean

    Зацикливается ли анимация

  • namestring

    Имя узла AnimationPlayer

  • node_pathstring

    Целевой путь узла для трека.

  • parentstring

    Путь родительского узла

  • project_pathstring

    Путь к каталогу проекта Godot

  • propertystring

    Целевое свойство для дорожки

  • scene_pathstring

    Путь к файлу сцены

  • track_typestring

    Тип трека: value, method, bezier

audio

Управление аудиошинами и потоками. Действия: list_buses|add_bus|add_effect|create_stream. Используйте help tool для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • busstring

    Аудиошина (по умолчанию: Master)

  • bus_namestring

    Имя аудиошины.

  • effect_typestring

    Тип эффекта (для add_effect)

  • namestring

    Имя узла потокового плеера.

  • parentstring

    Путь родительского узла

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены (для create_stream)

  • send_tostring

    Отправка цели шины (по умолчанию: Master)

  • stream_typestring

    Тип потока: 2D, 3D или глобальный

configидемпотентный

Конфигурация сервера и окружение. Действия (обязательные параметры -> необязательные): - status: текущая конфигурация - set (key, value): обновляет настройку - detect_godot: находит путь к бинарному файлу Godot - check: проверяет проект и доступность Godot

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • keystring

    Ключ конфигурации (для набора)

  • valuestring

    Значение конфигурации (для установки)

editorидемпотентный

Контрол редактора Godot. Действия (обязательные параметры -> необязательные): - launch (-> project_path): открывает редактор - status (-> project_path): проверяет, запущен ли редактор Для запуска игры используйте project(action="run").

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • project_pathstring

    Путь к каталогу проекта Godot

helpтолько чтениеидемпотентный

Полная документация для инструмента. Используйте, когда сжатых описаний недостаточно.

Параметры
  • topicenum

    Тема документации. Оставьте пустой, чтобы прочитать overview.md.

input_map

Управление входными действиями. Действия (обязательные параметры -> необязательные): - list (-> project_path): все входные действия - add_action (action_name -> deadzone=0.5, project_path) - remove_action (action_name -> project_path) - add_event (action_name, event_type, event_value -> project_path) event_type: key | mouse | joypad. event_value: например, KEY_SPACE.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • action_namestring

    Введите название действия.

  • deadzonenumber

    Значение мертвой зоны (для add_action, по умолчанию: 0.5)

  • event_typestring

    Тип события: клавиатура, мышь, джойпад (для add_event)

  • event_valuestring

    Значение события, например, KEY_SPACE (для add_event)

  • project_pathstring

    Путь к каталогу проекта Godot

navigation

Навигационные области, агенты, препятствия. Действия: create_region|add_agent|add_obstacle. Используйте help tool для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • dimensionstring

    2D или 3D (по умолчанию: 3D)

  • max_speednumber

    Максимальная скорость агента.

  • namestring

    Имя узла.

  • parentstring

    Путь к родительскому узлу (по умолчанию: .)

  • project_pathstring

    Путь к каталогу проекта Godot

  • radiusnumber

    Радиус агента/препятствия

  • scene_pathstring

    Путь к файлу сцены

nodes

Операции с узлами сцены. Действия (обязательные параметры -> необязательные): - add (scene_path, name -> type="Node", parent=".", project_path) - remove (scene_path, name -> project_path) - rename (scene_path, name, new_name -> project_path) - list (scene_path -> project_path) - set_property (scene_path, name, property, value -> project_path) - get_property (scene_path, name, property -> project_path) Пути узлов: относительно корня сцены с использованием "/" (например, "Player/Sprite2D"). Используйте "." для корня.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • namestring

    Имя узла.

  • new_namestring

    Новое имя (для переименования)

  • parentstring

    Путь родительского узла относительно корня сцены (для добавления, по умолчанию: "." = корень). Используйте разделитель "/", например, "Player/Sprite2D".

  • project_pathstring

    Путь к каталогу проекта Godot

  • propertystring

    Имя свойства (для get/set_property)

  • scene_pathstring

    Путь к файлу сцены

  • typestring

    Тип узла (для добавления, по умолчанию: Node)

  • valuestring

    Значение свойства (для set_property)

physics

Physics config. Действия: layers|collision_setup|body_config|set_layer_name. Используйте help tool для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • collision_layernumber

    Битовая маска слоя коллизий

  • collision_masknumber

    Битовая маска столкновений

  • dimensionstring

    2D или 3D (для set_layer_name)

  • gravity_scalenumber

    Масштаб гравитации (для body_config)

  • layer_numbernumber

    Номер слоя (для set_layer_name)

  • massnumber

    Масса (для body_config)

  • namestring

    Имя узла.

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены

project

Операции с проектами Godot. Действия (обязательные параметры -> необязательные): - info (-> project_path): возвращает метаданные проекта - version: версия движка Godot - run (-> scene_path, project_path): запускает игру - logs (-> pid): последние захваченные строки stdout/stderr из запуска (по умолчанию: последний запущенный) - stop: останавливает запущенную игру - settings_get (key -> project_path): читает настройку проекта - settings_set (key, value -> project_path): записывает настройку проекта - export (preset, output_path -> project_path): экспортирует сборку игры

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • keystring

    Ключ настроек (для settings_get/set)

  • output_pathstring

    Путь вывода (для экспорта)

  • pidnumber

    PID для чтения логов (для логов; по умолчанию: последний запущенный)

  • presetstring

    Имя пресета экспорта (для экспорта)

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к конкретной сцене для запуска (необязательно).

  • valuestring

    Значение настройки (для settings_set)

resources

Управление файлами ресурсов. Действия (обязательные параметры -> опциональные): - list (-> type, project_path): просматривает ресурсы (type: image|audio|font|shader|scene|resource) - info (resource_path -> project_path): получает метаданные ресурса - delete (resource_path -> project_path): удаляет - import_config (resource_path -> project_path): показывает настройки импорта

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • project_pathstring

    Путь к каталогу проекта Godot

  • resource_pathstring

    Путь к файлу ресурса

  • typestring

    Фильтр по типу: изображение, аудио, шрифт, шейдер, сцена, ресурс (для списка)

scenes

CRUD для файлов сцен (.tscn). Действия (обязательные параметры -> необязательные): - create (scene_path -> root_type="Node2D", root_name, project_path) - list (-> project_path) - info (scene_path -> project_path) - delete (scene_path -> project_path) - duplicate (scene_path, new_path -> project_path) - set_main (scene_path -> project_path) scene_path: относительно корня проекта (например, "scenes/main.tscn"), НЕ с префиксом res://. Используйте инструмент nodes для редактирования узлов в сцене.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • new_pathstring

    Путь назначения (для дубликата)

  • project_pathstring

    Путь к каталогу проекта Godot

  • root_namestring

    Имя корневого узла для создания.

  • root_typestring

    Тип корневого узла для создания (по умолчанию: Node2D)

  • scene_pathstring

    Относительный путь к файлу сцены от корня проекта (например, "scenes/main.tscn"), без префикса res://

scripts

GDScript file CRUD. Действия (обязательные параметры -> опциональные): - create (script_path -> extends="Node", content, project_path): генерирует шаблон - read (script_path -> project_path) - write (script_path, content -> project_path): заменяет весь файл - attach (script_path, scene_path, node_name -> project_path): привязывает к узлу сцены - list (-> project_path) - delete (script_path -> project_path) script_path: относительно корня проекта (например, "scripts/player.gd").

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • contentstring

    Содержимое скрипта (для создания/записи)

  • extendsstring

    Базовый класс для создания (по умолчанию: Node)

  • node_namestring

    Имя целевого узла (для присоединения)

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены (для прикрепления)

  • script_pathstring

    Путь к файлу GDScript

shader

Управление шейдерами Godot. Действия: create|read|write|get_params|list. Для полной документации используйте help tool.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • contentstring

    Содержимое шейдера (для создания/записи)

  • project_pathstring

    Путь к каталогу проекта Godot

  • shader_pathstring

    Путь к файлу .gdshader

  • shader_typestring

    Тип шейдера: canvas_item, spatial, particles, sky, fog (для создания)

signals

Управление подключениями сигналов. Действия (обязательные параметры -> необязательные): - list (scene_path -> project_path): все подключения сигналов - connect (scene_path, signal, from, to, method -> flags, project_path) - disconnect (scene_path, signal, from, to, method -> project_path)

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • flagsnumber

    Флаги соединения.

  • fromstring

    Путь исходного узла

  • methodstring

    Имя целевого метода.

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены

  • signalstring

    Имя сигнала

  • tostring

    Путь целевого узла.

tilemap

Управление TileSet и TileMap. Действия: create_tileset|add_source|set_tile|paint|list. Используйте help tool для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены (для списка, отрисовки)

  • texture_pathstring

    Путь к источнику текстуры (для add_source)

  • tileset_pathstring

    Путь к файлу TileSet .tres (для create_tileset, add_source)

  • tile_sizenumber

    Размер тайла в пикселях (по умолчанию: 16, для create_tileset)

ui

Узлы управления UI и темы. Действия: create_control|set_theme|layout|list_controls. Используйте инструмент help для полной документации.

Параметры
  • actionenumобязательный

    Выполняемое действие.

  • font_sizenumber

    Размер шрифта по умолчанию (для set_theme)

  • namestring

    Имя управляющего узла

  • parentstring

    Путь к родительскому узлу (по умолчанию: .)

  • presetstring

    Пресет макета: full_rect, center, top_wide, bottom_wide, left_wide, right_wide

  • project_pathstring

    Путь к каталогу проекта Godot

  • scene_pathstring

    Путь к файлу сцены

  • theme_pathstring

    Путь к файлу темы .tres (для set_theme)

  • typestring

    Тип элемента управления (например, Кнопка, Метка, HBoxContainer)

1.24.4основная
1.24.3
1.24.2
1.24.1
1.24.0
1.23.3
1.23.3-beta.1
1.23.2
1.23.1
1.23.1-beta.1
1.23.0
1.23.0-beta.1
1.22.0
1.21.0
1.21.0-beta.1
1.20.0
1.20.0-beta.4
1.20.0-beta.3
1.20.0-beta.2
1.20.0-beta.1
1.19.1
1.19.1-beta.1
1.19.0
1.19.0-beta.4
1.19.0-beta.3
1.19.0-beta.2
1.19.0-beta.1
1.18.9-beta.2
1.18.9-beta.1
1.18.8
1.18.8-beta.1
1.18.7
1.18.6
1.18.6-beta.1
1.18.5
1.18.5-beta.1
1.18.4
1.18.3
1.18.3-beta.1
1.18.2
1.18.2-beta.1
1.18.1
1.18.1-beta.1
1.18.0
1.18.0-beta.1
1.17.0
1.17.0-beta.1
1.16.0
1.16.0-beta.4
1.16.0-beta.3
1.16.0-beta.2
1.16.0-beta.1
1.15.2
1.15.1
1.15.0
1.14.1-beta.1
1.14.0
1.13.5
1.13.4
1.13.3
1.13.2
1.13.1
1.13.0
1.12.2
1.12.1
1.12.0
1.11.0
1.10.1
1.10.0
1.9.1
1.9.1-beta.1
1.9.0
1.8.0
1.8.0-beta.1
1.7.0
1.7.0-beta.2
1.7.0-beta.1
1.6.2
1.6.1
1.6.0
1.5.1
1.5.1-beta.2
1.5.0
1.4.7
1.4.6
1.4.5
1.4.4
1.4.3
1.4.2
1.4.1
1.4.0
1.3.0
1.2.3
1.2.2
1.2.1
1.2.0
1.1.1
1.1.0
1.0.1
1.0.0

Выберите клиент, чтобы установить n24q02m/better-godot-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"n24q02m-better-godot-mcp-1p17oa7z6g\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@n24q02m/better-godot-mcp\"],\"env\":{\"GODOT_PROJECT_PATH\":\"/path/to/your/godot/project\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add n24q02m-better-godot-mcp-1p17oa7z6g --env GODOT_PROJECT_PATH=/path/to/your/godot/project -- npx -y @n24q02m/better-godot-mcp

Либо через JSON-конфиг:

claude mcp add-json n24q02m-better-godot-mcp-1p17oa7z6g "{\"command\":\"npx\",\"args\":[\"-y\",\"@n24q02m/better-godot-mcp\"],\"env\":{\"GODOT_PROJECT_PATH\":\"/path/to/your/godot/project\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add n24q02m-better-godot-mcp-1p17oa7z6g --env GODOT_PROJECT_PATH=/path/to/your/godot/project -- npx -y @n24q02m/better-godot-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.n24q02m-better-godot-mcp-1p17oa7z6g]
command = "npx"
args = ["-y", "@n24q02m/better-godot-mcp"]

[mcp_servers.n24q02m-better-godot-mcp-1p17oa7z6g.env]
GODOT_PROJECT_PATH = "/path/to/your/godot/project"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите n24q02m/better-godot-mcp, а в поле команды запуска — строку ниже:
npx -y @n24q02m/better-godot-mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например n24q02m-better-godot-mcp-1p17oa7z6g.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: n24q02m-better-godot-mcp-1p17oa7z6g
    command: npx
    args:
      - "-y"
      - "@n24q02m/better-godot-mcp"
    env:
      GODOT_PROJECT_PATH: /path/to/your/godot/project
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "n24q02m-better-godot-mcp-1p17oa7z6g": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-godot-mcp"
      ],
      "env": {
        "GODOT_PROJECT_PATH": "/path/to/your/godot/project"
      }
    }
  }
}

Похожие MCP-сервера

Erodenn/godot-mcp-runtime

Erodenn/godot-mcp-runtime

от erodenn

MCP-сервер для Godot 4, который даёт AI-агентам полный контроль над проектом: редактирование сцен, нод, скриптов и запуск с runtime-мостом для скриншотов, симуляции ввода и live GDScript. Незаменим...

TypeScript⭐ 93
coding-solo/godot-mcp

coding-solo/godot-mcp

от coding-solo

Запускает проекты Godot, открывает редактор и перехватывает отладочный вывод. Создаёт сцены, добавляет ноды, экспортирует MeshLibrary для GridMap.

JavaScript⭐ 6197
gregario/godot-forge

gregario/godot-forge

от gregario

Godot Forge - MCP-сервер для Godot 4: тест-раннер, документация API, анализ скриптов и сцен. Исправляет типичные ошибки AI при написании GDScript и помогает мигрировать с Godot 3. Работает без конфигурации.

TypeScript⭐ 9
dmang-dev/mcp-retroarch

dmang-dev/mcp-retroarch

от dmang-dev

MCP-сервер для управления RetroArch через его сетевой интерфейс: читает и пишет память эмуляции, управляет сохранениями, делает скриншоты, ставит паузу и сбрасывает игру. Подходит для автоматизации...

TypeScript⭐ 5
jkiley129/steam-mcp

jkiley129/steam-mcp

от jkiley129

Этот MCP сервер подключает Claude к вашей библиотеке Steam. Ищите игры по названию, времени, статусу, получайте детали: жанры, рейтинг, цену. Задавайте вопросы на естественном языке - сервер сам работает с API Steam.

TypeScript⭐ 6
alex-gon/thegamecrafter-mcp-server

alex-gon/thegamecrafter-mcp-server

от alex-gon

MCP сервер, связывающий ИИ-ассистента с API The Game Crafter для проектирования и оценки настольных игр через естественный язык. Просмотр каталога компонентов, создание проектов, добавление карт и плат, загрузка изображений, мгновенный расчёт цены — всё через ассистента. Полезен инди-дизайнерам и...

TypeScript⭐ 3
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин