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

Сервер автоматически определяет, подключен ли плагин, и использует оптимальный режим.

Что позволяет делать этот сервер

Делать ВСЁ в Godot на естественном языке (83 инструмента + 20 ресурсов + 20 промптов):

Установка (уже выполнено)

Установленные требования

• Node.js (для MCP-сервера)

• Godot 4.5.1: C:\Dev\Godot_v4.5.1-stable_win64.exe\Godot_v4.5.1-stable_win64_console.exe

• uv (современный менеджер 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

Примечание: Модели -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 - Запуск редактора Godot

• run_project - Запуск проекта

• stop_project - Остановка проекта

• list_projects - Список проектов в папке

• get_project_info - Информация о проекте

• get_godot_version - Версия Godot

• get_project_settings - Чтение настроек проекта

• set_project_setting - Изменение настройки

• manage_input_actions - Управление действиями ввода

• manage_autoloads - Управление автозагрузкой

• validate_project - Проверка структуры проекта

• convert_project - Конвертация проекта из Godot 3 в 4

• validate_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 - Создание AnimationPlayer

• add_animation - Добавление анимации

• add_animation_track - Добавление трека (значение, позиция, вращение и т.д.)

• set_keyframe - Установка ключевого кадра с переходом/сглаживанием

• create_animation_tree - Создание AnimationTree

• setup_state_machine - Настройка машины состояний

• blend_animations - Настройка смешивания анимаций

Физика (3 инструмента)

• create_collision_shape - Создание CollisionShape2D/3D

• setup_rigidbody - Настройка RigidBody (масса, гравитация)

• configure_physics_layers - Именование физических слоев 2D/3D

TileMap (5 инструментов)

• create_tileset - Создание TileSet с размером тайла

• create_tilemap_layer - Создание TileMapLayer

• set_tile - Размещение тайла

• paint_tiles - Пакетная отрисовка тайлов

• import_ldtk_level - Импорт уровня LDtk

Аудио (3 инструмента)

• create_audio_bus - Создание аудиошины

• setup_audio_player - Настройка AudioStreamPlayer

• add_audio_effect - Добавление эффекта (реверберация, задержка, эквалайзер)

Шейдеры (2 инструмента)

• create_shader - Создание файла .gdshader

• create_shader_material - Создание ShaderMaterial

Навигация (2 инструмента)

• create_navigation_region - Создание NavigationRegion2D/3D

• bake_navigation_mesh - Запекание navmesh

Частицы (2 инструмента)

• create_gpu_particles - Создание GPUParticles2D/3D

• create_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 - Экспорт только PCK

• list_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 проектов с открытым исходным кодом:

Примечание: 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 build

Godot не найден

Убедитесь, что 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_modele

TODO

• [ ] Настроить 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