godot-mcp — сервер MCP (Model Context Protocol) для разработки Godot 4.x с поддержкой ИИ. Он предоставляет клиентам ИИ структурированный способ проверки и изменения проектов Godot вместо угадывания в форматах [[T1], .gd, .gdshader, .tres или project.godot.

Он предоставляет **99 инструментов ** в 13 категориях для манипулирования сценами, генерации сценариев, создания шейдеров, рабочих процессов анимации, настройки InputMap, настройки аудиомаршрутизации / проигрывателя, настройки навигации, построения пользовательского интерфейса, процедурной генерации, настройки проекта, управления редактором в реальном времени и автоматизации среды выполнения.

Как это работает вместе

Частица, роль [скрыто] [скрыто] [скрыто] godot-mcp[править править вики-текст]] Разоблачает поверхность инструмента, которую может вызвать ваш клиент ИИ. addons/godot_ai_bridge | Факультативный плагин Godot, включенный в это репо. Требуется для управления живым редактором, автоматизации ввода времени выполнения и скриншотов. ! [8][править править вики-текст] Добавляет знания и уровни рабочего процесса для генерации кода, дизайна сцены, шейдеров и работы в режиме live Godot. Включает в себя расширенные навыки godot-interactive для постоянных циклов редактора / рабочего времени. !

Рекомендуемый компаньон: ** Совместите этот MCP с godot-claude-skills. godot-mcp предоставляет инструменты.

Godot MCP Server

godot-mcp is an MCP (Model Context Protocol) server for AI-assisted Godot 4.x development. It gives AI clients a structured way to inspect and change Godot projects instead of guessing at .tscn, .gd, .gdshader, .tres, or project.godot formats.

It exposes 99 tools across 13 categories for scene manipulation, script generation, shader creation, animation workflows, InputMap setup, audio routing/player setup, navigation setup, UI building, procedural generation, project setup, live editor control, and runtime automation.

How It Fits Together

Recommended companion: Pair this MCP with godot-claude-skills. godot-mcp provides the tools. The skill pack improves how an agent uses them, especially through its godot-interactive workflow.

Features

File-Based Tools (Always Available)

• Scene Tools: Read, write, and manipulate .tscn scene files
• Script Tools: Generate and analyze GDScript files
• Shader Tools: Create shaders with 11 preset effects (dissolve, outline, hologram, etc.)
• Resource Tools: Manage .tres resource files
• Animation Tools: Create and edit animation clips, keyframes, and scene animation setup
• Input Tools: Manage InputMap actions/bindings and apply control presets
• Audio Tools: Create bus layouts and configure AudioStreamPlayer nodes
• Navigation Tools: Set up navigation regions, agents, and links in scene files
• UI Tools: Create themes, menus, HUDs, dialogs, and responsive layouts
• Procedural Generation: Dungeons, tilemaps, and enemy wave configurations

Live Editor Tools (Requires Godot AI Bridge Plugin)

• Real-time scene tree inspection
• Live node manipulation with undo/redo support
• Run/stop scenes directly from your AI assistant
• Capture runtime errors and console output
• Select nodes in the editor
• Drive the running game with synthetic actions, pointer events, and text entry
• Capture viewport screenshots from the running game

Documentation

• Built-in Godot 4.x class documentation
• Searchable API reference for commonly used engine classes

Quick Start

1. Build the MCP server from source.
2. Point your MCP client at dist/index.js and pass --project /path/to/your/godot/project.