DG

derfirm/godot-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

57 stars 9 forks Качество 87 Тренд 27MIT

Сервер Model Context Protocol (MCP) для взаимодействия с игровым движком Godot.

Обзор

Сервер Model Context Protocol (MCP) для взаимодействия с игровым движком Godot. Godot MCP позволяет ИИ-ассистентам запускать редактор Godot, запускать проекты, захватывать вывод отладки и управлять выполнением проектов через стандартизированный интерфейс. Этот цикл прямой обратной связи помогает помощникам ИИ понять, что работает, а что нет в проектах Godot, что приводит к лучшему генерированию кода и отладке. - : Откройте редактор Godot для конкретного проекта - : Выполните проекты Godot в режиме отладки - : Восстановите вывод консоли и сообщения об ошибках - : Начните и остановите проекты Godot программно - : Восстановите установленную версию Godot - : Найдите проекты Godot в указанном каталоге - : Получите подробную информацию о структуре проекта - Создание новых сцен с заданными типами корневых узлов - Добавление, удаление, изменение и дублирование узлов - Информация и свойства узлов запросов - Загрузка спрайтов и текстур в узлы Sprite2D - Экспорт 3D сцен в качестве ресурсов MeshLibrary для GridMap - Сохранение сцен с...

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP) для взаимодействия с игровым движком Godot.

##Введение

Godot MCP позволяет ИИ-ассистентам запускать редактор Godot, запускать проекты, захватывать вывод отладки и управлять выполнением проектов через стандартизированный интерфейс.

Этот цикл прямой обратной связи помогает помощникам ИИ понять, что работает, а что нет в проектах Godot, что приводит к лучшему генерированию кода и отладке.

** Текущая версия: ** 0.1.0 ** Godot Version Required: ** 4.5.0 или более поздняя версия Статус: Активное развитие

Особенности

Запуск редактора Godot: Откройте редактор Godot для конкретного проекта Проекты Run Godot: выполнение проектов Godot в режиме отладки

  • Захват отладочной продукции Восстановление вывода консоли и сообщений об ошибках Контрольная казнь: Запуск и остановка проектов Godot Get Godot Version: Retrieve the installed Godot version Список проектов Godot: найдите проекты Godot в указанном каталоге Проектный анализ: получить подробную информацию о структуре проекта

Управление сценами

Создание новых сцен с определенными типами корневых узлов

  • Добавлять, удалять, изменять и дублировать узлы
  • Информация и свойства узла запроса

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

Godot MCP

A Model Context Protocol (MCP) server for interacting with the Godot game engine.

Introduction

Godot MCP enables AI assistants to launch the Godot editor, run projects, capture debug output, and control project execution through a standardized interface.

This direct feedback loop helps AI assistants understand what works and what doesn’t in Godot projects, leading to better code generation and debugging assistance.

Current Version: 0.1.0
Godot Version Required: 4.5.0 or later
Status: Active Development

Features

  • Launch Godot Editor: Open the Godot editor for a specific project
  • Run Godot Projects: Execute Godot projects in debug mode
  • Capture Debug Output: Retrieve console output and error messages
  • Control Execution: Start and stop Godot projects programmatically
  • Get Godot Version: Retrieve the installed Godot version
  • List Godot Projects: Find Godot projects in a specified directory
  • Project Analysis: Get detailed information about project structure

Scene Management

  • Create new scenes with specified root node types
  • Add, remove, modify, and duplicate nodes
  • Query node information and properties
  • Load sprites and textures into Sprite2D nodes
  • Export 3D scenes as MeshLibrary resources for GridMap
  • Save scenes with options for creating variants

Script Management

  • Create GDScript files with templates (node, resource, custom)
  • Attach scripts to nodes
  • Validate script syntax with detailed error reporting
  • Get node methods and properties

Resource Management

  • Import assets with custom settings
  • Create resources (materials, shaders, etc.)
  • List project assets with metadata
  • Configure import settings

Signal System

  • Create custom signals in scripts
  • Connect signals between nodes with validation
  • List available signals on nodes
  • Disconnect signal connections

Physics System (Godot 4.5+)

  • Add physics bodies (CharacterBody2D/3D, RigidBody2D/3D, etc.)
  • Configure physics properties and materials
  • Setup collision layers and masks
  • Create Area2D/Area3D with signal connections

UI System

  • Create UI elements (Button, Label, TextEdit, Panel, etc.)
  • Apply themes to UI elements
  • Setup container layouts
  • Create menus with buttons and navigation

Animation System

  • Create AnimationPlayer nodes with animations
  • Add keyframes to animation tracks
  • Setup AnimationTree with state machines
  • Add particle systems (GPUParticles2D/3D)

Project Management

  • Update project settings
  • Configure input action mappings
  • Setup autoload singletons
  • Manage editor plugins (list, enable, disable)

Debug Module

  • Run projects with full debug output capture
  • Get error context with stack traces
  • Intelligent error analysis with solutions
  • Integration with documentation for contextual help

Documentation Module (Godot 4.5+)

  • Get detailed class information from official Godot documentation
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "godot": { "command": "node", "args": ["/absolute/path/to/godot-mcp/build/index.js"], "env": { "DEBUG": "true" // Optional: Enable detailed logging }, "disabled": false, "autoApprove": [ "launch_editor", "run_project", "get_debug_output", "stop_project", "get_godot_version", "list_projects", "get_project_info", "create_scene", "add_node", "remove_node", "modify_node", "duplicate_node", "query_node", "load_sprite", "export_mesh_library", "save_scene", "create_script", "attach_script", "validate_script", "get_node_methods", "import_asset", "create_resource", "list_assets", "configure_import", "create_signal", "connect_signal", "list_signals", "disconnect_signal", "add_physics_body", "configure_physics", "setup_collision_layers", "create_area", "create_ui_element", "apply_theme", "setup_layout", "create_menu", "create_animation_player", "add_keyframes", "setup_animation_tree", "add_particles", "get_uid", "update_project_uids", "get_class_info", "get_method_info", "search_docs", "get_best_practices", "run_with_debug", " …