godotiq — MCP-сервер для Claude Code: анализ проектов Godot 4
MCP-сервер для Godot 4: разбирает сцены, код и связи между узлами, чтобы агент видел структуру проекта. Пригодится, когда надо разобраться в чужом проекте или проверить последствия правки.
claude mcp add godotiq -e GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> -- uvx godotiqЧто делает godotiq
godotiq подключается к ИИ-клиенту как MCP-сервер и отдаёт агенту инструменты для работы с проектом Godot 4. В заявленном наборе 38 инструментов: анализ кода, пространственные данные о сценах, трассировка сигналов и потоков. Часть аналитики — графы зависимостей, проверка влияния правок, картирование сцен — входит в платный пакет Pro. В бесплатном режиме эти инструменты показывают превью, чтобы было видно, что даёт апгрейд.
Установка идёт через uvx, вручную ставить ничего не нужно: клиент подтянет пакет при первом обращении. В конфиге MCP-сервера обязательна переменная GODOTIQ_PROJECT_ROOT с путём к проекту Godot. Для Pro в тот же блок env добавляется GODOTIQ_LICENSE_KEY. Аддон в сам проект ставится отдельно командой uvx godotiq install-addon /path/to/your/godot/project.
Активация Pro работает по подписанной квитанции, поэтому после включения лицензии сетевых запросов на горячем пути нет. Без GODOTIQ_PROJECT_ROOT сервер не поймёт, какой проект анализировать, — это первое, что стоит проверить в конфиге.
Какие задачи решает
- разобраться в структуре чужого проекта Godot 4
- проследить, куда уходит сигнал от узла
- оценить, что сломается после правки сцены
- найти зависимости между скриптами и ресурсами
- дать агенту доступ к пространственным данным сцены
Примеры запросов агенту
- Покажи граф зависимостей сцены
Main.tscn - Какие узлы зависят от скрипта
player.gd? - Проследи, куда уходит сигнал
body_enteredв этом проекте
Как установить godotiq
Командой платформы
claude mcp add godotiq -e GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> -- uvx godotiqВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from godotiq <команда>
Командой платформы
codex mcp add godotiq --env GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> -- uvx godotiqВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from godotiq <команда>
Файл настроек
{
"mcpServers": {
"godotiq": {
"command": "uvx",
"args": [
"godotiq"
],
"env": {
"GODOTIQ_PROJECT_ROOT": "<GODOTIQ_PROJECT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from godotiq <команда>
Файл настроек
{
"servers": {
"godotiq": {
"type": "stdio",
"command": "uvx",
"args": [
"godotiq"
],
"env": {
"GODOTIQ_PROJECT_ROOT": "<GODOTIQ_PROJECT_ROOT>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from godotiq <команда>
Командой платформы
gemini mcp add -e GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> godotiq uvx godotiqВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from godotiq <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о godotiq
Как установить godotiq в Claude Code?
Выполните claude mcp add godotiq -e GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> -- uvx godotiq. Второй вариант — claude mcp add --env GODOTIQ_PROJECT_ROOT=<GODOTIQ_PROJECT_ROOT> --transport stdio godotiq -- uvx godotiq. Не забудьте подставить путь к своему проекту Godot.
Что делает godotiq?
Даёт агенту инструменты для анализа проекта Godot 4: код, сцены, зависимости, сигналы. Всего 38 инструментов, часть из них раскрывается только в Pro.
Что нужно для работы godotiq?
Переменная GODOTIQ_PROJECT_ROOT с путём к проекту Godot — без неё сервер не знает, что анализировать. Для Pro в блок env добавляется GODOTIQ_LICENSE_KEY.
