gdharness — MCP-сервер для Claude Code: установка и возможности
gdharness даёт агенту доступ к запущенному проекту Godot: он может проверять интерфейс, ввод, состояние узлов и ошибки.
claude mcp add --env GODOT_PATH=<GODOT_PATH> --transport stdio gdharness -- npx -y gdharnessЧто делает gdharness
gdharness связывает агент с проектом Godot через аддоны, мост выполнения, MCP-сервер и CLI. Агент запускает редактор, находит элементы по тексту, нажимает на узлы, читает свойства и выводит содержимое консоли с трассировками. Ответы берутся из состояния движка, а не из повторения параметров запроса.
Сервер предоставляет 30 инструментов, 4 ресурса godot:// и 3 промпта. Он умеет работать с редактором, запущенной игрой и файлами проекта; отладчик редактора позволяет ставить breakpoint и читать переменные в текущей области. Для работы нужны Godot 4.7 или новее и Node 22 или новее, также поддерживается Bun 1.4. Без Godot 4.7 сервер выходит за пределы проверенной совместимости.
Какие задачи решает
- запустить проект Godot из агента
- найти элемент интерфейса по тексту
- проверить текст и свойства узла
- передать игре нажатие или другой ввод
- прочитать ошибки с трассировкой из редактора
Примеры запросов агенту
- Запусти проект из
C:/games/hallчерезeditor_run, затем найди кнопку с текстом «Buy». - Нажми на узел
/root/Hall/Ledger/BuyButtonчерезruntime_inputи прочитай текст панели/root/Hall/Ledger. - Проверь вывод редактора для проекта
C:/games/hallчерезeditor_outputи разберись с ошибкой по трассировке.
Как установить gdharness
Командой платформы
claude mcp add --env GODOT_PATH=<GODOT_PATH> --transport stdio gdharness -- npx -y gdharnessВместо <…> подставьте свои значения
Командой платформы
codex mcp add gdharness --env GODOT_PATH=<GODOT_PATH> -- npx -y gdharnessВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"gdharness": {
"command": "npx",
"args": [
"-y",
"gdharness"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"gdharness": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"gdharness"
],
"env": {
"GODOT_PATH": "<GODOT_PATH>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e GODOT_PATH=<GODOT_PATH> gdharness npx -y gdharnessВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о gdharness
Как установить gdharness в Claude Code?
Выполните claude mcp add gdharness -- npx -y gdharness.
Что делает gdharness?
MCP-сервер позволяет агенту управлять запуском Godot-проекта, проверять состояние интерфейса и узлов, передавать ввод и читать ошибки редактора.
Какие версии Godot и Node нужны для работы?
Нужны Godot 4.7 или новее и Node 22 или новее. Сервер также запускается под Bun 1.4; более старые версии Godot 4.x не проходили проверку.
