Каталог MCP
gregario/godot-forge

gregario/godot-forge

Name: gregario/godot-forge
Availability: InStock
Author: gregario

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

Github NPM Сайт сервера

README

8 инструментов

Версии

Установить сервер

Godot Forge

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

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.

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"]
    }
  }
}

Инструменты были проиндексированы: 21.10.2026

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

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

Параметры

pathstringобязательный
Путь к файлу .tscn или .tres (например, res://scenes/main.tscn)

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

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

Параметры

pathstringобязательный
Путь к файлу .gd (например, res://scripts/player.gd)

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

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

Параметры

pathstring
Путь к файлу для получения диагностики (например, scripts/player.gd). Опустите для всего проекта.
portnumber
Порт LSP (по умолчанию: 6005)

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

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

Параметры

detailenum
Уровень детализации: 'summary' (по умолчанию) для подсчётов и каталогов верхнего уровня, 'full' для полного перечисления файлов.

godot_run_project

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

Параметры

actionenumобязательный
Выполняемое действие.
scenestring
Сцена, запускаемая напрямую (например, res://scenes/main.tscn)

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

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

Параметры

frameworkenum
Принудительно указать конкретный фреймворк (автоматически определяется, если не указано)
inner_classstring
Фильтровать по конкретному внутреннему тестовому классу.
methodstring
Фильтровать по конкретному имени тестового метода.
script_pathstring
Фильтровать по конкретному тестовому скрипту (например, res://tests/test_inventory.gd)
timeoutnumber
Таймаут в секундах (по умолчанию: 60)

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

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

Параметры

scenestring
Сцена для захвата (например, res://scenes/main.tscn). Если не указана, захватывает главную сцену проекта.

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

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

Параметры

querystringобязательный
Имя класса (например, 'CharacterBody2D'), метод (например, 'CharacterBody2D.move_and_slide') или поисковый термин

`0.1.4`основная	26.04.2026
`0.1.3`	16.03.2026
`0.1.2`	13.03.2026
`0.1.1`	13.03.2026
`0.1.0`	13.03.2026

Выберите клиент, чтобы установить gregario/godot-forge:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "gregario-godot-forge-93fnm84rqc": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"gregario-godot-forge-93fnm84rqc\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"godot-forge\"]}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add gregario-godot-forge-93fnm84rqc -- npx -y godot-forge

Либо через JSON-конфиг:

claude mcp add-json gregario-godot-forge-93fnm84rqc "{\"command\":\"npx\",\"args\":[\"-y\",\"godot-forge\"]}"

Codex

Добавьте сервер командой в терминале:

codex mcp add gregario-godot-forge-93fnm84rqc -- npx -y godot-forge

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.gregario-godot-forge-93fnm84rqc]
command = "npx"
args = ["-y", "godot-forge"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите gregario/godot-forge, а в поле команды запуска — строку ниже:

npx -y godot-forge

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ],
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например gregario-godot-forge-93fnm84rqc.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: gregario-godot-forge-93fnm84rqc
    command: npx
    args:
      - "-y"
      - "godot-forge"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "gregario-godot-forge-93fnm84rqc": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "godot-forge"
  ]
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

Информация о сервере

Номер в рейтинге: #197
Звезд на Github: 9
Форков на Github: 3
Загрузок: 1 929
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 21.10 в 04:48
Идентификатор: aIXCTf7Qz2ziv8XG
Категории: Анализ кода, Игры и геймификация, Инструменты для разработчиков

gregario/godot-forge

Godot Forge

Install

Add to your IDE

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

Erodenn/godot-mcp-runtime

pzalutski-pixel/godotlens-mcp

n24q02m/better-godot-mcp

coding-solo/godot-mcp

HadiCherkaoui/crafty-mcp

gregario/lorcana-oracle