gregario/godot-forge

gregario/godot-forge

от gregario
Godot Forge - MCP-сервер для Godot 4: тест-раннер, документация API, анализ скриптов и сцен. Исправляет типичные ошибки AI при написании GDScript и помогает мигрировать с Godot 3. Работает без конфигурации.

Godot Forge

The MCP server for Godot 4. Test runner, API docs, script analysis, and more.

npm version npm downloads MIT License Node.js 18+ MCP Compatible godot-forge MCP server


AI coding assistants are structurally bad at GDScript. Models trained on data skewed towards Godot 3 hallucinate deprecated APIs (yield instead of await, KinematicBody instead of CharacterBody3D, export var instead of @export var). Godot Forge fixes this.

8 tools. Zero config. Works with every MCP-compatible IDE.

godot-forge MCP server

Install

npx -y godot-forge

That's it. Godot Forge auto-detects your Godot binary (Steam, Homebrew, direct download) and finds your project.godot automatically.

Add to your IDE
Claude Code
claude mcp add godot-forge -- npx -y godot-forge
Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "godot-forge": {
      "command": "npx",
      "args": ["-y", "godot-forge"]
    }
  }
}
VS Code (Copilot)

Add to .vscode/mcp.json:

{
  "servers": {
    "godot-forge": {
      "command": "npx",
      "args": ["-y", "godot-forge"]
    }
  }
}
Инструменты были проиндексированы:
godot_analyze_sceneтолько чтениеидемпотентный

Разбирает файлы сцен .tscn или файлы ресурсов .tres и возвращает структурированный анализ. Обнаруживает антипаттерны (глубокая вложенность, перегруженные сцены, отсутствующие скрипты) и ошибки форматирования (preload в .tres, пользовательские имена классов в поле type, целочисленные идентификаторы ресурсов).

Параметры
  • pathstringобязательный

    Path to .tscn or .tres file (e.g., res://scenes/main.tscn)

godot_analyze_scriptтолько чтениеидемпотентный

Проанализируйте GDScript-файлы на все 10 проверенных на практике ошибок: неправильное использование API Godot 3→4, огромные скрипты, := на Variant, тесная связь, реентерабельность сигналов, неправильное использование автозагрузок, пропущенное отключение сигнала, время _init(), питонизмы и static func на автозагрузках.

Параметры
  • pathstringобязательный

    Path to .gd file (e.g., res://scripts/player.gd)

godot_get_diagnosticsтолько чтениеидемпотентный

Получить диагностику LSP (ошибки, предупреждения) от встроенного языкового сервера Godot. Требуется, чтобы редактор Godot был запущен с открытым проектом.

Параметры
  • pathstring

    File path to get diagnostics for (e.g., scripts/player.gd). Omit for project-wide.

  • portnumber

    LSP port (default: 6005)

godot_get_project_infoтолько чтениеидемпотентный

Возвращает обзор структуры проекта: название проекта, версию Godot, сцены, скрипты, автозагрузки, аддоны и дерево каталогов. Использует прогрессивное раскрытие: по умолчанию сводка, по запросу полные детали.

Параметры
  • detailenum

    Level of detail: 'summary' (default) for counts and top-level dirs, 'full' for complete file listings

godot_run_project

Запускает, останавливает или получает отладочный вывод из запущенного проекта Godot. Захватывает stdout/stderr с временными метками.

Параметры
  • actionenumобязательный

    Action to perform

  • scenestring

    Scene to launch directly (e.g., res://scenes/main.tscn)

godot_run_testsидемпотентный

Запускает тесты GUT или GdUnit4 в безголовом режиме и возвращает структурированные результаты (пройдено/не пройдено). Автоматически определяет тестовый фреймворк. Возвращает общее количество, количество пройденных и не пройденных тестов с подробностями ошибок, включая пути к файлам и номера строк.

Параметры
  • frameworkenum

    Force specific framework (auto-detected if omitted)

  • inner_classstring

    Filter to specific inner test class

  • methodstring

    Filter to specific test method name

  • script_pathstring

    Filter to specific test script (e.g., res://tests/test_inventory.gd)

  • timeoutnumber

    Timeout in seconds (default: 60)

godot_screenshotтолько чтениеидемпотентный

Захватить снимок viewport из запущенного проекта Godot. Возвращает PNG-изображение в кодировке base64. Требуется дисплейный сервер (не headless-режим).

Параметры
  • scenestring

    Scene to capture (e.g., res://scenes/main.tscn). If omitted, captures the project's main scene.

godot_search_docsтолько чтениеидемпотентный

Ищет документацию по API Godot 4.x. Возвращает обзоры классов, детали методов или результаты нечёткого поиска. Автоматически определяет запросы по API Godot 3 и предлагает эквиваленты для Godot 4 - основной источник AI-генерируемых ошибок в GDScript.

Параметры
  • querystringобязательный

    Class name (e.g., 'CharacterBody2D'), method (e.g., 'CharacterBody2D.move_and_slide'), or search term

Похожие MCP-сервера

Erodenn/godot-mcp-runtime

Erodenn/godot-mcp-runtime

MCP-сервер для Godot 4, который даёт AI-агентам полный контроль над проектом: редактирование сцен, нод, скриптов и запуск с runtime-мостом для скриншотов, симуляции ввода и live GDScript. Незаменим...

TypeScript70
pzalutski-pixel/godotlens-mcp

pzalutski-pixel/godotlens-mcp

MCP-сервер для семантического анализа GDScript (15 инструментов) через Godot Language Server. Дает AI-агентам точную навигацию, рефакторинг и диагностику без ложных срабатываний grep.

Python8
n24q02m/better-godot-mcp

n24q02m/better-godot-mcp

Сервер для разработки игр на Godot Engine с AI-агентами: 17 инструментов для управления сценами, скриптами и ресурсами напрямую, без запуска редактора. Ускоряет создание прототипов.

TypeScript37
coding-solo/godot-mcp

coding-solo/godot-mcp

MCP сервер для разработчиков на Godot: запускает редактор, выполняет проекты, захватывает отладку и управляет сценами. Интеграция с AI позволяет быстро проверять код и отлаживать игры прямо в движке.

JavaScript5612
Coding-Solo/godot-mcp

Coding-Solo/godot-mcp

MCP-сервер для Godot: запускает редактор, выполняет проекты, захватывает отладку. Управляет сценами и проектами. Полезен разработчикам, использующим AI-агентов — даёт обратную связь от движка, уско...

JavaScript5612
gregario/dnd-oracle

gregario/dnd-oracle

MCP сервер для D&D 5e: поиск монстров, заклинаний и экипировки, построение встреч и анализ партии. Работает офлайн на проверенных SRD данных, никаких галлюцинаций. Полезен для мастеров и игроков: б...

TypeScript5
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин