Godot MCP Unified
Godot MCP Unified - Архитектура ИИ + Godot
Документация для моего будущего «я» - Полная настройка для написания кода на естественном языке в Godot
Общая архитектура
+------------------+
| Claude Code |
| (VS Code) |
+--------+---------+
|
v
+----------------+ +--------+---------+ +------------------+
| Claude Desktop |->| |<-| ollmcp (Ollama) |
| (Anthropic) | | godot-mcp-unified| | qwen2.5-coder:7b |
+----------------+ | (ce serveur) | +------------------+
+--------+---------+
|
+--------------+--------------+
| |
v v
+--------+---------+ +--------+---------+
| Godot CLI | | Plugin WebSocket|
| (--headless) | | (addons/godot_ |
| Fallback mode | | mcp/) Port 6505|
+------------------+ +------------------+
| |
+-------------+---------------+
|
v
+--------+---------+
| Godot Engine |
| 4.5.1 |
+------------------+Взаимодействие с Godot
Режим | Когда | Преимущества |
WebSocket-плагин | Плагин активен в редакторе | В реальном времени, доступ к EditorInterface |
CLI Fallback | Плагин недоступен | Работает без открытого редактора |
Сервер автоматически определяет, подключен ли плагин, и использует оптимальный режим.
Related MCP server: Godot MCP
Что позволяет делать этот сервер
Делать ВСЁ в Godot на естественном языке (83 инструмента + 20 ресурсов + 20 промптов):
Функционал | Описание | Пример |
Скрипты CRUD | Создание/чтение/изменение/удаление GDScript | "Создай скрипт движения для игрока" |
Сцены | Создание и изменение сцен .tscn | "Создай сцену Player с CharacterBody2D" |
Узлы | Добавление/изменение/удаление узлов | "Добавь Sprite2D к Player" |
Анимация | AnimationPlayer, треки, ключевые кадры | "Создай анимацию ходьбы из 4 кадров" |
Физика | Collision shapes, rigidbody, слои | "Настрой физику игрока" |
TileMap | TileSet, TileMapLayer, размещение тайлов | "Создай тайлмеп с тайлами ландшафта" |
Аудио | Аудиошины, плееры, эффекты | "Добавь реверберацию на шину Master" |
Шейдеры | Создание шейдеров и материалов | "Создай шейдер растворения" |
Навигация | Регионы и navmesh | "Настрой навигацию для ИИ" |
Частицы | GPU-частицы и материалы | "Добавь частицы огня" |
UI | Контейнеры и элементы управления | "Создай главное меню" |
Освещение | 2D/3D свет и окружение | "Настрой освещение уровня" |
Ассеты | Импорт, список, переимпорт | "Импортируй текстуры из папки assets" |
Экспорт | Пресеты, экспорт проекта/PCK | "Выведи список пресетов экспорта" |
Пакетные операции | Последовательные операции | "Выполни эти 5 операций подряд" |
Отладка | Поток отладки WebSocket в реальном времени | "Запусти поток отладки на порту 9999" |
UID | Управление идентификаторами Godot 4.4+ | "Обнови ссылки UID" |
3D | Экспорт MeshLibrary для GridMap | "Экспортируй меши в MeshLibrary" |
Установка (уже выполнено)
Установленные требования
Node.js (для MCP-сервера)
Godot 4.5.1:
C:\Dev\Godot_v4.5.1-stable_win64.exe\Godot_v4.5.1-stable_win64_console.exeuv (современный менеджер Python)
ollmcp (мост Ollama <-> MCP)
Этот сервер
cd C:\Dev\godot-mcp-unified
npm install
npm run buildКонфигурация
Claude Desktop (C:\Users\pierr\AppData\Roaming\Claude\claude_desktop_config.json)
{
"mcpServers": {
"godot": {
"command": "node",
"args": ["C:\\Dev\\godot-mcp-unified\\build\\index.js"],
"env": {
"GODOT_PATH": "C:\\Dev\\Godot_v4.5.1-stable_win64.exe\\Godot_v4.5.1-stable_win64_console.exe"
}
}
}
}VS Code / Claude Code (.vscode/mcp.json в вашем проекте Godot)
{
"servers": {
"godot": {
"command": "node",
"args": ["C:\\Dev\\godot-mcp-unified\\build\\index.js"],
"env": {
"GODOT_PATH": "C:\\Dev\\Godot_v4.5.1-stable_win64.exe\\Godot_v4.5.1-stable_win64_console.exe"
}
}
}
}Ollama (через ollmcp)
# Lancer le bridge
ollmcp --model qwen2.5-coder:7b C:\Dev\godot-mcp-unified\build\index.js
# Ou via ollama-gateway (port 3010)Доступные модели Ollama
Модель | Размер | Использование |
| 4.7 GB | Основная для GDScript - 88.4% HumanEval |
| 4.4 GB | Повествование для jdvlh-ia-game |
| 5.4 GB | Эксперт FFE для chess-app |
| 4.7 GB | Вызов инструментов для chess-app |
| 2.0 GB | Легкий вызов инструментов для chess-app |
| 8.9 GB | Архитектура для chess-app |
Примечание: Модели -chess предназначены НЕ для игры в шахматы, а являются специализированными помощниками для разработки chess-app с системными промптами FFE.
Справочник API (83 инструмента + 20 ресурсов + 20 промптов)
Статистика
Primitives MCP:
Tools: 83/83 ████████████████████ 100%
Resources: 20/20 ████████████████████ 100%
Prompts: 20/20 ████████████████████ 100%
Qualite:
Tests: 3170+ ████████████████████ 100% pass (69 suites)
Coverage: 85% █████████████████░░░ 85%
Bridge Plugin:
Avec bridge: 47 outils (utilisent WebSocket si plugin actif)
Sans bridge: 35 outils (CLI/file I/O uniquement)Управление проектом (14 инструментов)
launch_editor- Запуск редактора Godotrun_project- Запуск проектаstop_project- Остановка проектаlist_projects- Список проектов в папкеget_project_info- Информация о проектеget_godot_version- Версия Godotget_project_settings- Чтение настроек проектаset_project_setting- Изменение настройкиmanage_input_actions- Управление действиями вводаmanage_autoloads- Управление автозагрузкойvalidate_project- Проверка структуры проектаconvert_project- Конвертация проекта из Godot 3 в 4validate_conversion- Проверка конвертацииgenerate_docs- Генерация документации GDScript
Управление сценами (15 инструментов)
create_scene- Создание новой сценыadd_node- Добавление узлаedit_node- Изменение свойств узлаremove_node- Удаление узлаrename_node- Переименование узлаmove_node- Перемещение узла (reparent)duplicate_node- Дублирование узлаload_sprite- Загрузка текстурыsave_scene- Сохранение сценыinstance_scene- Инстанцирование сценыlist_scenes- Список сценget_node_tree- Получение дерева сценыconnect_signal- Подключение сигналаmanage_groups- Управление группами узловexport_mesh_library- Экспорт в MeshLibrary
Скрипты GDScript (7 инструментов)
list_scripts- Список всех .gd файлов проектаread_script- Чтение содержимого скриптаwrite_script- Создание/изменение скриптаdelete_script- Удаление скриптаattach_script- Прикрепление скрипта к узлуdetach_script- Открепление скрипта от узлаget_script_errors- Ошибки компиляции
Анимация (7 инструментов)
create_animation_player- Создание AnimationPlayeradd_animation- Добавление анимацииadd_animation_track- Добавление трека (значение, позиция, вращение и т.д.)set_keyframe- Установка ключевого кадра с переходом/сглаживаниемcreate_animation_tree- Создание AnimationTreesetup_state_machine- Настройка машины состоянийblend_animations- Настройка смешивания анимаций
Физика (3 инструмента)
create_collision_shape- Создание CollisionShape2D/3Dsetup_rigidbody- Настройка RigidBody (масса, гравитация)configure_physics_layers- Именование физических слоев 2D/3D
TileMap (5 инструментов)
create_tileset- Создание TileSet с размером тайлаcreate_tilemap_layer- Создание TileMapLayerset_tile- Размещение тайлаpaint_tiles- Пакетная отрисовка тайловimport_ldtk_level- Импорт уровня LDtk
Аудио (3 инструмента)
create_audio_bus- Создание аудиошиныsetup_audio_player- Настройка AudioStreamPlayeradd_audio_effect- Добавление эффекта (реверберация, задержка, эквалайзер)
Шейдеры (2 инструмента)
create_shader- Создание файла .gdshadercreate_shader_material- Создание ShaderMaterial
Навигация (2 инструмента)
create_navigation_region- Создание NavigationRegion2D/3Dbake_navigation_mesh- Запекание navmesh
Частицы (2 инструмента)
create_gpu_particles- Создание GPUParticles2D/3Dcreate_particle_material- Создание ParticleProcessMaterial
UI (2 инструмента)
create_ui_container- Создание контейнера (VBox, HBox, Grid и т.д.)create_control- Создание элемента управления (Button, Label и т.д.)
Освещение (3 инструмента)
create_light- Создание света 2D/3D (Directional, Omni, Spot)setup_environment- Настройка окружения (туман, свечение, SSAO)setup_lightmapper- Настройка LightmapGI и запекания
Ассеты (3 инструмента)
list_assets- Список ассетов (изображения, аудио, модели)import_asset- Импорт внешнего файлаreimport_assets- Принудительный переимпорт
Экспорт (3 инструмента)
export_project- Экспорт проектаexport_pack- Экспорт только PCKlist_export_presets- Список пресетов экспорта
Пакетные операции (1 инструмент)
batch_operations- Выполнение нескольких инструментов MCP последовательно
Отладка (5 инструментов)
get_debug_output- Получение вывода консолиstart_debug_stream- Запуск WebSocket-сервера отладкиstop_debug_stream- Остановка WebSocket-сервераget_debug_stream_status- Статус сервераtake_screenshot- Сделать скриншот
UID (Godot 4.4+) (2 инструмента)
get_uid- Получение UID файлаupdate_project_uids- Обновление ссылок
Система (2 инструмента)
system_health- Проверка состояния системыget_godot_version- Версия Godot
Примеры использования
Создание персонажа игрока
"Cree une scene Player.tscn avec un CharacterBody2D comme root,
ajoute un Sprite2D nomme 'Sprite' et un CollisionShape2D nomme 'Collision'"Отладка проекта
"Lance mon projet Godot et montre-moi les erreurs dans la console"Изменение существующей сцены
"Dans la scene Player.tscn, change la position du Sprite a (100, 50)
et sa scale a 2x"Структура проектов Godot
C:\Dev\
├── jdvlh-godot-client\ <- Projet principal (pas de remote git configure!)
│ ├── project.godot
│ ├── .vscode\mcp.json <- Config MCP pour ce projet
│ └── addons\godot_mcp\ <- Plugin MCP copie
│
├── jdvlh-godot\ <- Projet vide (a garder pour tests)
│
└── GodotDynamicDialog\ <- Fork de dynamic-dialogПроисхождение кода
Этот сервер объединяет функционал 3 проектов с открытым исходным кодом:
Проект | Функционал | Репозиторий |
ee0pdt/Godot-MCP | Скрипты CRUD | |
bradypp/godot-mcp | Основная база - Сцены, узлы, UID, 3D | |
Coding-Solo/godot-mcp | Запуск, выполнение, отладка |
Примечание: GDAI MCP существует, но он платный ($19).
Характеристики машины
CPU: Ryzen 5 5600H
RAM: 16 GB
GPU: AMD Radeon (встроенная) - без CUDA
Оптимальная квантование: Q4_K_M (золотая середина качества/производительности)
Устранение неполадок
Сервер не запускается
cd C:\Dev\godot-mcp-unified
npm run buildGodot не найден
Убедитесь, что GODOT_PATH указывает на правильный исполняемый файл (консольная версия для просмотра логов).
Claude Desktop не видит инструменты
Перезапустите Claude Desktop после изменения конфигурации.
Полезные команды
# Rebuild le serveur
cd C:\Dev\godot-mcp-unified && npm run build
# Tester avec l'inspecteur MCP
npm run inspector
# Lister les modeles Ollama
ollama list
# Supprimer un modele Ollama
ollama rm nom_modeleTODO
[ ] Настроить git remote для jdvlh-godot-client
[ ] Очистить избыточные модели Ollama (qwen2.5, gemma2, llama3.2, deepseek-coder-v2)
[ ] Протестировать полную интеграцию с новым проектом
Последнее обновление: 11 февраля 2026 г. godot-mcp-unified v0.9.0 - 83 инструмента + 20 ресурсов + 20 промптов Покрытие: 85% | Тесты: 3170+ (69 наборов) | Соответствует ISO 25010/29119/5055/27001
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Make all the audio for your game from a single prompt. Describe your game and your AI assistant plans every sound it needs (sound effects, ambience loops, music tracks and character voice lines), then generates them all in one go. You get several AI versions of each sound and keep the ones you like. Sounds are organized per game in folders and scenes, and the free Godot plugin installs them into your project, ready to play with one line of code. Works with Claude, Claude Code, Cursor and any MCP client, with OAuth login (no API key needed). Free plan included; sounds can be used in commercial games.
Your own Claude designs and codes Godot 4 games; each build is tested with real screenshots.
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
One workspace of tools for Claude and ChatGPT: connect 600+ apps, generate media, build tools.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to create and modify Godot game engine projects by managing scenes, generating GDScript code, creating animations, and controlling the Godot editor through natural language commands.1MIT
- AlicenseAqualityDmaintenanceEnables AI agents to create, edit, and run Godot 4.5+ games by providing tools for project scaffolding, scene manipulation, and engine interaction. It supports full game development workflows including node editing, script attachment, and project execution with debugging capabilities.245MIT
- AlicenseCqualityDmaintenanceProvides AI assistants with full control over the Godot game engine through 157 operations including scene manipulation, runtime code execution, input simulation, and project management.19MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to build, run, and debug Godot projects by editing scenes and scripts, inspecting live game state, injecting input, capturing viewports, and examining native debugger state through 42 tools.European Union Public 1.2