Godot Forge — MCP-сервер для Godot 4: тесты, API и разбор сцен
MCP-сервер для Godot 4: запускает тесты, ищет в API, разбирает GDScript и сцены, отдаёт диагностику LSP. Пригодится, когда ассистент пишет код под Godot 3.
claude mcp add --env GODOT_PATH=<GODOT_PATH> --transport stdio godot-forge -- npx -y godot-forgeЧто делает Godot Forge
Модели, обученные на данных с перекосом в Godot 3, уверенно выдают yield вместо await, KinematicBody вместо CharacterBody3D и export var вместо @export var. Godot Forge подставляет правильный вариант Godot 4, когда ассистент спрашивает про устаревший API: в наборе больше 30 соответствий по классам, методам, синтаксису и константам.
Внутри восемь инструментов. godot_run_tests сам находит GUT или GdUnit4 и возвращает JSON с числом пройденных и упавших тестов, путями к файлам и номерами строк; можно фильтровать по скрипту, методу или внутреннему классу. godot_analyze_script ловит десять типовых ошибок GDScript — от устаревшего API до лишних get_node("../../...") и повторного входа в сигналы. godot_analyze_scene разбирает .tscn и .tres, godot_get_project_info показывает структуру проекта, godot_get_diagnostics берёт настоящие ошибки компилятора из языкового сервера Godot.
Шесть инструментов из восьми работают без установленного Godot. Запуск тестов, старт проекта и скриншот требуют бинарник, а диагностика LSP — ещё и открытый редактор с проектом. Путь к Godot ищется сам: переменная GODOT_PATH, затем godot или godot4 в PATH, потом установки Steam и системные каталоги. Если Godot лежит нестандартно, без GODOT_PATH сервер его не найдёт.
Какие задачи решает
- запустить тесты GUT или GdUnit4 и получить разбор упавших
- найти замену устаревшему API Godot 3 при миграции
- проверить скрипт на десять типовых ошибок GDScript
- разобрать
.tscnна глубокую вложенность и битые ссылки - получить настоящие ошибки компилятора из языкового сервера
Примеры запросов агенту
- Прогони тесты water profile и покажи, что упало
- Проверь
player.gdна устаревший API Godot 3 - Разбери
main.tscnи скажи, где слишком глубокая вложенность
Как установить Godot Forge
Командой платформы
claude mcp add --env GODOT_PATH=<GODOT_PATH> --transport stdio godot-forge -- npx -y godot-forgeВместо <…> подставьте свои значения
Командой платформы
codex mcp add godot-forge --env GODOT_PATH=<GODOT_PATH> -- npx -y godot-forgeВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"godot-forge": {
"command": "npx",
"args": [
"-y",
"godot-forge"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"godot-forge": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"godot-forge"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GODOT_PATH=<GODOT_PATH> godot-forge npx -y godot-forgeВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Godot Forge
Как установить Godot Forge в Claude Code?
Одна команда: claude mcp add godot-forge -- npx -y godot-forge. Если Godot лежит нестандартно, добавьте путь через переменную: claude mcp add --env GODOT_PATH=<GODOT_PATH> --transport stdio godot-forge -- npx -y godot-forge.
Что делает Godot Forge?
Даёт ассистенту восемь инструментов для Godot 4: запуск тестов, поиск по API с сопоставлением Godot 3 и 4, разбор скриптов и сцен, структура проекта, диагностика LSP, запуск проекта и скриншот вьюпорта.
Нужен ли установленный Godot?
Для шести инструментов из восьми — нет. Бинарник нужен, чтобы запускать тесты, стартовать проект и делать скриншоты; диагностика LSP дополнительно требует открытый редактор Godot с проектом.
