TG

tugcantopaloglu/godot-mcp

Developer tools

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

506 stars 74 forks Качество 91 Тренд 36MIT

tugcantopaloglu/godot-mcp — это кандидат на сервер MCP, импортированный из https://github.com/tugcantopaloglu/godot-mcp.

Обзор

tugcantopaloglu/godot-mcp — это кандидат на сервер MCP, импортированный из https://github.com/tugcantopaloglu/godot-mcp.

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

Комплексный сервер Model Context Protocol (MCP), который предоставляет AI-ассистентам полный контроль над игровым движком Godot. 157 инструментов охватывающих сети, 3D/2D-рендеринг, управление интерфейсом, аудиоэффекты, деревья анимации, ввод-вывод файлов, выполнение кода во время выполнения, инспекцию свойств, манипуляцию сценами, управление сигналами, физику, создание проектов и многое другое.

Благодарности

Этот проект основан на и расширяет godot-mcp Соломона Элиаса (Coding-Solo). Оригинальный проект предоставил базовую архитектуру, включая сервер TypeScript MCP, безголовую операционную систему GDScript и сервер взаимодействия во время выполнения на основе TCP. Спасибо, что сделали это возможным с помощью вашей отличной работы с открытым исходным кодом!

Что нового (улучшения по сравнению с оригиналом)

Оригинальный Godot-mcp предоставил 20 инструментов для базового управления проектами и создания сцен. Этот форк расширяет его до 157 инструментов со следующими крупными дополнениями:

Новинка в версии 3.1

  • validate_script разрешение автозагрузки - Проверка скрипта теперь компилирует цель через SceneTree в точке _initialize() (после регистрации автозагрузок проекта) вместо --check-only в _init().

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

README

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

Godot MCP - Full Control

A comprehensive Model Context Protocol (MCP) server that gives AI assistants full control over the Godot game engine. 157 tools spanning networking, 3D/2D rendering, UI controls, audio effects, animation trees, file I/O, runtime code execution, property inspection, scene manipulation, signal management, physics, project creation, and more.

Acknowledgments

This project is built upon and extends godot-mcp by Solomon Elias (Coding-Solo). The original project provided the foundational architecture including the TypeScript MCP server, headless GDScript operations system, and TCP-based runtime interaction server. Thank you for making this possible with your excellent open-source work!

What’s New (Improvements Over Original)

The original godot-mcp provided 20 tools for basic project management and scene creation. This fork extends it to 157 tools with the following major additions:

New in 3.1

  • validate_script autoload resolution - Script validation now compiles the target through a SceneTree at _initialize() (after project autoloads are registered) instead of --check-only at _init(). References to autoload singletons no longer produce false Identifier not found errors, while real syntax/type errors are still caught. Verified building a full game whose scripts reference several autoloads.
  • manage_input_map event merging - Adding a second key to an existing input action now merges it into that action’s events array (with physical_keycode de-duplication) instead of writing a duplicate actionname= line, which previously left project.godot malformed and silently dropped earlier bindings.

New in 3.0

  • .NET / C# support - Scaffold C# projects and generate C# scripts (create_project with dotnet: true, create_csharp_script); the .csproj SDK version is matched to your installed Godot.
  • GDScript diagnostics - Validate scripts for syntax and type errors without running the game (validate_script, and validate_scripts for all git-changed or project-wide files).
Открыть полный 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": { "GODOT_PATH": "/path/to/godot", "DEBUG": "true" } } } }