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, целочисленные идентификаторы ресурсов).

Разбирает файлы сцен .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(), Python-измы и статические функции в автозагрузках.

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

Параметры

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

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

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

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

Получить диагностику 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, сцены, скрипты, автозагрузки, аддоны и дерево каталогов. Использует прогрессивное раскрытие: по умолчанию сводка, по запросу полные детали.

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

Параметры

  • detailenum

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

    summaryfull
godot_run_project

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

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

Параметры

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

    Action to perform

    startstopget_output
  • scenestring

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

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

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

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

Параметры

  • script_pathstring

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

  • methodstring

    Filter to specific test method name

  • inner_classstring

    Filter to specific inner test class

  • frameworkenum

    Force specific framework (auto-detected if omitted)

    gutgdunit4
  • timeoutnumber

    Timeout in seconds (default: 60)

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

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

Захватить снимок 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.

Ищет документацию по 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-сервера

LaurieWired/GhidraMCP

LaurieWired/GhidraMCP

GhidraMCP — MCP-сервер для Ghidra, подключающий LLM к реверс-инжинирингу. Декомпилирует код, переименовывает методы, анализирует бинарники через MCP-клиенты. Ускоряет анализ вредоносного ПО.

Java9533
haris-musa/excel-mcp-server

haris-musa/excel-mcp-server

MCP-сервер для работы с Excel-файлами без установленного офиса. Создавайте, читайте и редактируйте книги, листы, формулы, диаграммы и сводные таблицы через AI-агента. Подходит для автоматизации раб...

Python4041
Jpisnice/shadcn-ui-mcp-server

Jpisnice/shadcn-ui-mcp-server

MCP-сервер для интеграции shadcn/ui v4 в AI-ассистенты. Дает доступ к компонентам, блокам и демкам для React, Svelte, Vue и React Native. Ускоряет разработку интерфейсов с помощью ИИ, поддерживает ...

TypeScript2871
21st-dev/Magic-MCP

21st-dev/Magic-MCP

MCP сервер 21st.dev Magic AI Agent помогает разработчикам создавать UI-компоненты через описание на естественном языке. Интегрируется с Cursor, Windsurf и VS Code, генерируя готовые компоненты.

TypeScript5468
intruder-io/intruder-mcp

intruder-io/intruder-mcp

официальный

MCP сервер для интеграции Intruder с ИИ-ассистентами Claude и Cursor. Он автоматизирует тестирование безопасности, запуская сканирования и управляя проектами. Полезен специалистам по безопасности и разработчикам.

Python26
Google Calendar MCP

Google Calendar MCP

Сервер для интеграции Google Календаря с AI-ассистентами через MCP. Управляйте событиями, проверяйте занятость и обнаруживайте пересечения между несколькими календарями и аккаунтами. Поддерживает импорт событий из изображений и ссылок. Помогает автоматизировать планирование и анализ календаря.

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

Лука Никитин